Waypoint Documentation

Learn and develop your knowledge of Waypoint with these tutorials and code resources.

Fundamentals

Quick Start
It only takes a few minutes to get started with Waypoint on your local development environment.
App Lifecycle
Waypoint has an opinionated view on the minimum application lifecycle: build, deploy, and release.
Projects
A project contains one or more applications and each one in a project represents a single deployable object.
Runners
Waypoint utilizes "runners" to execute jobs. Runners are programs running `waypoint runner agent`.
waypoint.hcl
The waypoint.hcl file configures each Waypoint project and defines how Waypoint builds, deploys, and releases it.

Overview
Waypoint can configure your application by setting environment variables and writing files.
Dynamic Values
Waypoint can sync app config values with external systems like Kubernetes ConfigMaps, HashiCorp Vault, and more.
Files
Waypoint can write configs to files for apps that expect configurations at a certain path or in a certain format.

Tips and Troubleshooting
Common tips and troubleshooting methods.
Logs
Waypoint app logs are aggregated and available to view via the CLI and UI.
Exec
Waypoint enables you to execute commands in the context of a deployed application.

Waypoint URL Service
The Waypoint URL service is a free, public service hosted by HashiCorp to view your deployed app.
Waypoint Runners
Waypoint has three types of runners to execute every operation: CLI, remote, and on-demand.
Waypoint Triggers
Trigger URLs are pre-configured Waypoint lifecycle operations for execution inside CI environments.