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
    • v0.8.x (latest)
    • v0.7.x
    • v0.6.x
    • v0.5.x
    • v0.4.x
    • v0.3.x
    • v0.2.x
    • v0.1.x
  • 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
  • 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

The Waypoint website is being redesigned to help you find what you are looking for more effectively.

Type '/' to Search

»Waypoint Project apply

Command: waypoint project apply

Create or update a project.

»Usage

Usage: waypoint project apply [options] NAME

Create or update a project.

This will create a new project with the given options. If a project with the same name already exists, this will update the existing project using the fields that are set.

This command should be used to create a new project pointing to a VCS repo. If you have a "waypoint.hcl" file and a local repository, you can also use "waypoint init" in the directory of the project.

You may create a project from a waypoint.hcl file and optionally overwrite some fields using flags by specifying the -waypoint-hcl flag.

»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

  • -from-waypoint-hcl=<string> - waypoint.hcl formatted file to load settings from. This can be used to read settings from a file. Additional flags will override values found in the file. Note that any settings in the file will NOT be merged with what is already in the server; they will overwrite the server.
  • -waypoint-hcl=<string> - Path to a waypoint.hcl file to associate with this project. This is only necessary if a waypoint.hcl is not committed alongside the project source code. If a waypoint.hcl file does not exist in the project source then this waypoint.hcl file will be used. This file will not be validated until an operation is run against the project; this is done on purpose since the waypoint.hcl file may depend on files in the source repository.
  • -data-source=<string> - The data source type to use (currently only supports 'git' or 'local'). Associated data source settings (such as flags starting with '-git') will not take effect unless the appropriate data source is set with this flag.
  • -git-url=<string> - URL of the Git repository to clone. This can be an HTTP or SSH URL.
  • -git-path=<string> - Path is a subdirectory within the checked out repository to go into for the project's configuration. This must be a relative path and may not contain '..'
  • -git-ref=<string> - Git ref (i.e. branch, tag, commit) to clone on new operations.
  • -git-auth-type=<string> - Authentication type for Git. If set, must be one of 'basic' or 'ssh'. Basic auth is username/password and SSH uses an SSH key.
  • -git-username=<string> - Username for authentication when git-auth-type is 'basic'. For GitHub, this can be any value but it must be non-empty.
  • -git-password=<string> - Password for authentication when git-auth-type is 'basic'. For GitHub, this should be a personal access token (PAT).
  • -git-private-key-path=<string> - Path to a PEM-encoded private key for 'ssh'-based auth.
  • -git-private-key-password=<string> - Password for the private key specified by git-private-key-path if the key requires a password to decode. This is not required if the private key doesn't require a password.
  • -git-recurse-submodules=<int> - The maximum depth to recursively clone submodules. A value of zero disables cloning any submodules recursively.
  • -poll - Enable polling. This is only valid if a Git data source is supplied. This will watch the repo for changes and trigger a remote 'up'.
  • -poll-interval=<string> - Interval between polling if polling is enabled.
  • -app-status-poll - Enable polling to continuously generate status reports for apps. This is only valid if a Git data source is supplied.
  • -app-status-poll-interval=<string> - Interval between polling to generate status reports if polling is enabled.
  • -runner-profile=<string> - Name of a runner profile to be used for this project
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