June 20-22 Announcing HashiConf Europe full schedule: keynotes, sessions, labs & more Register Now
  • 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
  • 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
  • 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
Type '/' to Search

»Waypoint Server run

Command: waypoint server run

Manually run the builtin server

»Usage

Usage: waypoint server run [options]

Run the builtin server.

The easier way to run a server is to use the "waypoint install" command. This command is for people who are manually running the server in any environment.

»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.

»Command Options

  • -db=<string> - Path to the database file.
  • -listen-grpc=<string> - Address to bind to for gRPC connections.
  • -listen-http=<string> - Address to bind to for HTTP connections. Required for the UI.
  • -listen-http-insecure=<string> - Address to bind to for insecure HTTP connections. This will not have TLS enabled. This will redirect users to the TLS port UNLESS there is an X-Forwarded-Proto header. This makes this port suitable for proxy backends.
  • -tls-cert-file=<string> - Path to a PEM-encoded certificate file for TLS. If this isn't set, a self-signed certificate will be generated. This file will be monitored for changes and will automatically reload on change.
  • -tls-key-file=<string> - Path to a PEM-encoded private key file for the TLS certificate specified with -tls-cert-file. This is required if -tls-cert-file is set. This file will be monitored for changes and will automatically reload on change
  • -disable-ui - Disable the embedded web interface
  • -url-enabled - Enable the URL service.
  • -url-api-addr=<string> - Address to Waypoint URL service API.
  • -url-api-insecure - True if TLS is not enabled for the Waypoint URL service API.
  • -url-control-addr=<string> - Address to Waypoint URL service control API.
  • -url-control-token=<string> - Token for the Waypoint URL server control API.
  • -url-auto-app-hostname - Whether apps automatically get a hostname on deploy.
  • -advertise-addr=<string> - Address to advertise for the server. This is used by the entrypoints binaries to communicate back to the server. If this is blank, then the entrypoints will not communicate to the server. Features such as logs, exec, etc. will not work.
  • -advertise-tls - If true, the advertised address should be connected to with TLS.
  • -advertise-tls-skip-verify - Do not verify the TLS certificate presented by the server.
  • -accept-tos - Pass to accept the Terms of Service and Privacy Policy to use the Waypoint URL Service. This is required if the URL service is enabled and you're using the HashiCorp-provided URL service rather than self-hosting. See the privacy policy at https://hashicorp.com/privacy and the ToS at https://waypointproject.io/terms
  • -telemetry-oc-agent-addr=<string> - Address of an OpenCensus agent or collector available to receive OpenCensus formatted telemetry, traces and stats (commonly port 55678). Example: localhost:55678
  • -telemetry-oc-agent-insecure - Disables client transport security for the OpenCensus agent exporter's gRPC connection.
  • -telemetry-dd-trace-addr=<string> - Address of a DataDog agent available to accept traces (commonly port 8126). Example: localhost:8126
  • -telemetry-oc-zpages-addr=<string> - If set, Waypoint will run an OpenCensus zPages server at this address. Typically this is set to something like localhost:9999, where trace debug information could be viewed at http://localhost:9999/debug/tracez, and rpc stats at http://localhost:55679/debug/rpcz. More information at https://opencensus.io/zpages/
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