Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

tractorbeam apply

Build and apply a Project to the control plane.

tractorbeam apply [flags]
Flag Description
--config <string> The Project’s tractorbeam.config.ts. Defaults to the one in the current directory or its nearest ancestor.
--workspace <string> Workspace identifier or resource name. Environment variable: TRACTORBEAM_WORKSPACE.
--origin <string> The Tractorbeam origin to call instead of the default, such as a proxy’s. Environment variable: TRACTORBEAM_ORIGIN.
--token <string> Access token. Defaults to the saved interactive session. Environment variable: TRACTORBEAM_TOKEN.
--branch <string> Branch identifier or resource name. Defaults to the Branch you last switched to, or main. Environment variable: TRACTORBEAM_BRANCH.
--adopt Adopt each Resource the Project registers that another Project owns, keeping its data. Without it, Apply refuses such a Resource.
--yes, -y Apply without asking even when the plan can lose data, such as by removing a Resource the Project no longer registers.

Examples:

# Apply the Project to the current Branch
tractorbeam apply

# Apply it to staging from a script, even when the plan can lose data
tractorbeam apply --branch staging --yes