New Interested in participating in the HCP Waypoint Private Beta Program? Apply here
  • 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
    • Overview
      • Overview
      • Helm
      • Heroku, Vercel, etc.
      • Kubernetes
  • Getting Started
    • Overview
    • Compatibility Promise
    • Protocol Version Table
    • Release Notifications
      • Overview
      • Upgrade to 0.2.0
      • Upgrade to 0.3.0
      • Upgrade to 0.4.0
      • Upgrade to 0.5.0
      • Upgrade to 0.6.0
      • Upgrade to 0.7.0
      • Upgrade to 0.8.0

    • Install
    • Externally Built Images
    • Building Container Images
    • Helm Deployment
    • YAML-Free Deployment
    • YAML Directory Deployment
    • Resource Status
    • ConfigMaps and Secrets

    • Overview
    • Git Integration
    • Remote Operations
    • Overview
    • Build
    • Deploy
    • Release
    • Hooks
    • Labels
    • Workspace and Label Scoping
    • Overview
      • Overview
      • Input Variables
      • External Data
      • artifact
      • deploy
      • entrypoint
      • labels
      • path
      • workspace
      • Overview
      • Full Reference
      • Templating
      • Overview
      • Expressions
      • JSON Syntax
    • app
    • build
    • config
    • deploy
    • hook
    • plugin
    • registry
    • release
    • runner
    • url
    • use
    • variable
  • URL Service
  • Logs
  • Exec
    • Overview
    • Dynamic Values
    • Files
    • Internal Values
    • Workspace and Label Scoping
    • Overview
      • Overview
      • OIDC
      • Tokens
      • Overview
      • Maintenance
      • Production
      • Security
    • Express Server Install
    • Overview
    • Configuration
    • Profiles
    • On-Demand Runner
    • Additional Runners
  • Workspaces
  • Plugins
  • Triggers

    • Overview
      • Overview
      • Registering Plugin Components
      • Handling Configuration
      • Implementing the Builder Interface
      • Compiling the Plugin
      • Creating an Example Application
      • Testing the Plugin
    • Initializing the SDK
    • Passing Values Between Components
      • Overview
      • Authenticator
      • ConfigSourcer
      • Configurable
      • ConfigurableNotify
      • Builder
      • Registry
      • Platform
      • ReleaseManager
      • Destroy
      • Status
      • Default Parameters
      • Overview
    • Overview
    • Disable
    • Overview
    • GitHub Actions
    • GitLab CI/CD
    • CircleCI
    • Jenkins
  • Troubleshooting
  • Glossary

    • Overview
    • Architecture
    • Operation Execution
  • Roadmap
Type '/' to Search

»Waypoint Glossary

This page lists and defines technical terms used throughout Waypoint. Words such as "project", "app", etc. can be overloaded in the technical community, so this page attempts to clarify their meaning in the context of Waypoint.

The easiest way to navigate this page is to use the "Jump to Section" dropdown under the title above or use your browser's search functionality (Cmd-F or Ctrl-F).

»Project

A project in Waypoint is represented by a single "waypoint.hcl" file and is a 1:1 mapping to a VCS repository (if one exists). A project can be comprised of one or more applications.

The purpose of the "project" is to give Waypoint a single name to refer to a repository or collection of applications. Some features are used at the project scope, such as setting application configuration.

»Application (or "App")

An application is defined using the app stanza in a "waypoint.hcl" and represents a unit that is deployed. Multiple applications may exist in a single project, which may represent a project that is comprised of separate deployable units. For example: a backend, a frontend, a service worker, etc. may each be a separate application.

»Parameter

A "parameter" is the term used to describe any configuration object.

»Stanza

A "stanza" is a block of code that opens and closes with braces { } and may contain more configuration parameters. Below, app "label-name" {} is the app stanza.

app "label-name" {
  #...
}
app "label-name" {
  #...
}

A stanza is a parameter, but not all parameters are stanzas.

»Label

A label for a stanza is identified by the quotation marks "". The app stanza takes a label named "label-name".

app "label-name" {
  #...
}
app "label-name" {
  #...
}

»Entrypoint

The Waypoint Entrypoint is a special binary (named waypoint-entrypoint) that launches your application and is used to enable a lot of Waypoint functionality. The entrypoint is sometimes referred to as the "CEB" which stands for "custom entrypoint binary."

»Client

A Waypoint client is anything that interacts with the server to inspect, create, update, or destroy projects, applications, etc. The most common Waypoint client is the CLI or web UI.

»Server

A Waypoint server is the running server that stores data and orchestrates operations such as builds, deploys, etc. A client interacts with a server. The server is deployed using waypoint install.

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