New Interested in participating in the HCP Waypoint Private Beta Program? Apply here
  • Infrastructure
    • terraform
    • packer
  • Networking
    • consul
  • Security
    • vault
    • boundary
  • Applications
    • nomad
    • waypoint
    • vagrant
  • HashiCorp Cloud Platform

    A fully managed platform to automate infrastructure on any cloud with HashiCorp products.

    • consul
    • terraform
    • vault
    • packerbeta
    Visit cloud.hashicorp.com
  • Overview
  • Tutorials
  • Docs
  • CLI
  • Plugins
  • Community
GitHub
Download
    • v0.8.x (latest)
    • v0.7.x
    • v0.6.x
    • v0.5.x
    • v0.4.x
    • v0.3.x
    • v0.2.x
    • v0.1.x
  • build
  • deploy
  • destroy
  • exec
  • init
  • install
  • login
  • logs
  • release
  • ui
  • up

  • artifact build
  • artifact list-builds
  • artifact list
  • artifact push
  • auth-method list
  • auth-method inspect
  • auth-method set oidc
  • auth-method delete
  • config get
  • config set
  • config source-get
  • config source-set
  • config sync
  • context
  • context clear
  • context create
  • context delete
  • context inspect
  • context list
  • context rename
  • context use
  • context verify
  • context set
  • deployment deploy
  • deployment destroy
  • deployment list
  • docs
  • fmt
  • hostname delete
  • hostname list
  • hostname register
  • job list
  • job inspect
  • job cancel
  • job get-stream
  • plugin
  • project apply
  • project inspect
  • project list
  • release list
  • runner agent
  • runner list
  • runner inspect
  • runner adopt
  • runner forget
  • runner reject
  • runner token
  • runner profile list
  • runner profile inspect
  • runner profile set
  • server bootstrap
  • server cookie
  • server config-set
  • server install
  • server restore
  • server run
  • server snapshot
  • server uninstall
  • server upgrade
  • status
  • trigger create
  • trigger update
  • trigger delete
  • trigger inspect
  • trigger list
  • user inspect
  • user invite
  • user modify
  • user token
  • version
  • workspace create
  • workspace inspect
  • workspace list

  • k8s bootstrap
  • token exchange
  • token invite
  • token new

The Waypoint website is being redesigned to help you find what you are looking for more effectively.

Type '/' to Search

»Waypoint Login

Command: waypoint login

Log in to a Waypoint server

»Usage

Usage: waypoint login [server address]

Log in to a Waypoint server.

This is usually the first command a new user runs to gain CLI access to an existing Waypoint server.

If the server address is not specified and you have an active context (see "waypoint context"), then this command will reauthenticate to the currently active server.

This command can be used for token-based authentication as well as other forms such as OIDC. You can use "-token" to specify a login or invite token and configure the CLI to access the server.

The "-from-kubernetes" flag can be used after a fresh Waypoint installation on Kubernetes to log in using the bootstrap token. This requires local Kubernetes connection configuration via a KUBECONFIG environment variable or file.

»Global Options

  • -plain - Plain output: no colors, no animation.
  • -app=<string> (-a) - App to target. Certain commands require a single app target for Waypoint configurations with multiple apps. If you have a single app, then this can be ignored.
  • -project=<string> (-p) - Project to target.
  • -workspace=<string> (-w) - Workspace to operate in.

»Connection Options

  • -server-addr=<string> - Address for the server.
  • -server-tls - True if the server should be connected to via TLS.
  • -server-tls-skip-verify - True to skip verification of the TLS certificate advertised by the server.

»Command Options

  • -auth-method=<string> - Auth method to use for login. This will default to the only available auth method if only one exists.
  • -token=<string> - Auth with a token. This will force auth-method to 'token'. This works with both login and invite tokens.
  • -from-kubernetes - Perform the initial authentication after Waypoint is installed to Kubernetes. This requires kubectl to be configured with access to the Kubernetes cluster. The primary use case of this is to get the first token from a Waypoint installation. After that, future users should use a configured auth method or request a token from an administrator.
  • -from-kubernetes-service=<string> - The name of the Kubernetes service to get the server address from when using the -from-kubernetes flag.
  • -from-kubernetes-secret=<string> - The name of the Kubernetes secret that has the Waypoint token when using the -from-kubernetes flag.
  • -from-kubernetes-namespace=<string> - The name of the Kubernetes namespace that has the Waypoint token when using the -from-kubernetes flag.
github logoEdit this page

Using Waypoint

The best way to understand what Waypoint can enable for your projects is to give it a try.

Waypoint tutorials
Waypoint documentation
Tutorial

Get Started - Kubernetes

Build, deploy, and release applications to a Kubernetes cluster.

View
Tutorial

Introduction to Waypoint

Waypoint enables you to publish any application to any platform with a single file and a single command.

View

Waypoint is maintained by HashiCorp, Inc.

View Code of Conduct
DocumentationCLI ReferenceTutorialsIntegrations
All systems normal