Adding Waypoint

In some cases, you may want to use Waypoint, allowing developers to deploy, manage, and observe their applications through a consistent abstraction of underlying infrastructure.


To interact with a Waypoint server and runners, you first need to install Waypoint on your machine.

TLDR: For macOS with Homebrew:

$ brew install hashicorp/tap/waypoint

Installing Waypoint on Nomad

Since we already have a running Nomad cluster, adding Waypoint to HashiBox is pretty straightforward.

By running the following command, you install a Waypoint server on the Nomad client in the us-west-1 datacenter, and register related services in Consul:

$ export NOMAD_ADDR=
$ waypoint install -accept-tos -platform=nomad \
  -nomad-host= \
  -nomad-region=us \
  -nomad-dc=us-west-1 \
  -nomad-consul-service=true \
  -nomad-consul-service-hostname= \
  -nomad-consul-datacenter=us \
  -nomad-host-volume=waypoint-server \

No need to manually create the Nomad host volumes waypoint-server and waypoint-runner. They already have been created by Nomad clients via the configuration files.

Once done, the Waypoint UI is available at

Is something missing?

If you notice something we've missed or could be improved on, please follow this link and submit a pull request to the repository. Once we merge it, the changes will be reflected on the website the next time it is deployed. Thank you for your contributions!
Built by