• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Waypoint
  • Install
  • Tutorials
  • Documentation
  • CLI
  • Plugins
  • Try Cloud(opens in new tab)
  • Sign up
Waypoint Home

CLI

Skip to main content
  • CLI
  • 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
  • pipeline inspect
  • pipeline list
  • pipeline run
  • plugin
  • project apply
  • project destroy
  • project inspect
  • project list
  • release list
  • runner agent
  • runner list
  • runner inspect
  • runner install
  • runner uninstall
  • runner adopt
  • runner forget
  • runner reject
  • runner token
  • runner profile delete
  • 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
  • task list
  • task cancel
  • task inspect
  • 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

  • Resources

  • Tutorial Library
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  1. Developer
  2. Waypoint
  3. CLI

Waypoint Commands (CLI)

Waypoint is controlled via a very easy to use command-line interface (CLI). Waypoint is only a single command-line application: `waypoint`. This application then takes a subcommand such as `artifact` or `deployment`.

Waypoint is controlled via a very easy to use command-line interface (CLI). Waypoint is only a single command-line application: waypoint. This application then takes a subcommand such as artifact or deployment. The complete list of subcommands is in the navigation to the left.

The waypoint CLI is a well-behaved command line application. In erroneous cases, a non-zero exit status will be returned. It also responds to -h and --help as you'd most likely expect.

To view a list of the available commands at any time, just run waypoint with no arguments:

$ waypoint
Usage: waypoint [-version] [-help] [-autocomplete-(un)install] <command> [args]

Common commands:
    build        Build a new versioned artifact from source
    deploy       Deploy a pushed artifact
    release      Release a deployment
    up           Perform the build, deploy, and release steps

Other commands:
    artifact        Artifact and build management
    auth-method     Auth method management
    config          Application configuration management
    context         Server access configurations
    deployment      Deployment creation and management
    destroy         Delete all the resources created
    docs            Show documentation for components
    exec            Execute a command in the context of a running application instance
    fmt             Rewrite waypoint.hcl configuration to a canonical format
    hostname        Application URLs
    init            Initialize and validate a project
    install         Install the Waypoint server to Kubernetes, Nomad, or Docker
    logs            Show log output from the current application deployment
    project         Project management
    runner          Runner management
    server          Server management
    ui              Open the web UI
    user            User information and management
    version         Prints the version of this Waypoint CLI

To get help for any specific command, pass the -h flag to the relevant subcommand. For example, to see help about the up subcommand:

$ waypoint up -h
Usage: waypoint up [options]

  Perform the build, deploy, and release steps.

Global Options:

  -app=<string>
      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. This is aliased as "-a".

  -plain
      Plain output: no colors, no animation. The default is false.

  -project=<string>
      Project to target. This is aliased as "-p".

  -workspace=<string>
      Workspace to operate in. This is aliased as "-w".

Operation Options:

  -label=<key=value>
      Labels to set for this operation. Can be specified multiple times.

  -local
      True to use a local runner to execute the operation, false to use a
      remote runner. If unset, Waypoint will automatically determine where the
      operation will occur, defaulting to remote if possible.

  -remote-source=<key=value>
      Override configurations for how remote runners source data. This is
      specified to the data source type being used in your configuration. This
      is used for example to set a specific Git ref to run against.

  -var=<key=value>
      Variable value to set for this operation. Can be specified multiple
      times.

  -var-file=<string>
      HCL or JSON file containing variable values to set for this operation.
      If any "*.auto.wpvars" or "*.auto.wpvars.json" files are present, they
      will be automatically loaded.

Command Options:

  -prune
      Prune old unreleased deployments. The default is true.

  -prune-retain=<int>
      The number of unreleased deployments to keep. If this isn't set or is
      set to any negative number, then this will default to 1 on the server.
      If you want to prune all unreleased deployments, set this to 0. The
      default is -1.

Running waypoint -autocomplete-install will add the waypoint autocomplete capability so you can do waypoint <tab> on commands. Running waypoint -autocomplete-uninstall will remove it. Please note that this will modify your shell init script, so you will need to reload your shell.

Edit this page on GitHub
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)