»Waypoint Server Installation
The recommended way to install the server is using the
waypoint install command.
This command will install a server into Docker, Kubernetes, or Nomad,
bootstrap the server, and configure your local CLI to access that server.
It is a single command to get up and running with Waypoint.
You can also run and configure the server manually using the
waypoint server run command. This is meant for more advanced
users who want to run Waypoint in a platform that the
install command doesn't support
or to fine-tune the configuration of the server.
Note: Only one Waypoint server needs to be installed and run for any group of people using Waypoint together. If you are a day-to-day user of Waypoint with a group of people you may not need to install a server. In this case, see the documentation on connecting to a server.
For details on upgrading the server, please see the general Waypoint upgrade documentation.
»Manually Running the Server
waypoint install is built to help you setup a Waypoint server, but
we understand there are going to be many cases where you'll want to run
Waypoint manually. To run a Waypoint server manually, you'll use the
waypoint server run command.
The instructions below are only if you're manually running a server
waypoint server run.
»Start the Server
First, start the server:
$ waypoint server run -db=data.db » Server configuration: DB Path: data.db gRPC Address: 127.0.0.1:9701 HTTP Address: 127.0.0.1:9702 Auth Required: yes Browser UI Enabled: yes URL Service: api.waypoint.run:443 (account: token) ...
waypoint server run command takes a variety of flags for configuration.
See the CLI help output for more information.
Note: At the time of writing, Waypoint is limited to using self-signed TLS certificates and does not accept file-based configuration. This limitation will be fixed very soon.
If you're manually running the server, we will assume that you know how to use a scheduler such as Nomad or service manager such as systemd to run this command in a production environment.
»Bootstrap the Server
If this is your first time starting the server against the configured database path, then you will be required to bootstrap the server to retrieve the initial auth token.
waypoint server run output should contain instructions on how to do
this, including a CLI command you can copy and paste. The output should
look like the following:
$ waypoint server run ... » Server requires bootstrapping! New servers must be bootstrapped to retrieve the initial auth token for connections. To bootstrap this server, run the following command in your terminal once the server is up and running. waypoint server bootstrap -server-addr=127.0.0.1:9701 -server-tls-skip-verify This command will bootstrap the server and setup a CLI context.
Copy and paste that command to bootstrap:
$ waypoint server bootstrap -server-addr=127.0.0.1:9701 -server-tls-skip-verify
This will output the bootstrap token but more importantly this will configure
a CLI context automatically. You can now verify
the connection using
waypoint context verify.
At this point, the running server is ready for use!