- Optionally updates packages when running locally.
- Compiles and bundles the code.
- Deploys the code to the Trigger.dev instance.
- Registers the tasks as a new version in the environment you pass with
--env.
Deploying from CI
When deploying from CI/CD environments such as GitHub Actions, GitLab CI, or Jenkins, you need to authenticate non-interactively by setting theTRIGGER_ACCESS_TOKEN environment variable. Please see the CI / GitHub Actions guide for more information.
Arguments
Options
Load environment variables from a file. This will only hydrate the
process.env of the CLI
process, not the tasks.The environment to deploy to:
prod, staging or preview. If you specify preview we will
try and automatically detect the branch name from git. When you don’t pass --env, the deploy
goes to the environment of the API key in TRIGGER_ACCESS_TOKEN, or to prod if you’re using a
personal access token. We recommend always passing --env.When using
--env preview the branch is automatically detected from git. But you can manually
specify it by using this option, e.g. --branch my-branch or -b my-branch.Create a deployable build but don’t deploy it. Prints out the build path so you can inspect it.
Attach your own identifier to this deployment — a commit SHA, release tag or CI run id, up to 128
characters. Your app can then send the same id when triggering, and runs are pinned to this
deployment. See version skew protection.Repeating an id that is already deployed doesn’t build again: the CLI reports the existing version,
sets the same outputs, and exits successfully. Repeating an id that has a build in flight is an
error. An id whose build failed rebuilds normally.The short-circuit is keyed on the id, not on the build inputs — so redeploying the same id after
changing a synced environment variable produces no new build.
Start a new build for an
--external-id that already has one. Non-destructive with respect to
deployments that already succeeded — both remain and the newer version wins. If a build for that
id is still in flight, --force cancels it first, so one id never has two live builds. A
cancelled build usually stops within seconds, but one running on another machine can keep going
briefly before it notices. Requires --external-id.Install and bundle on your machine, then build the image on the build server from the uploaded
bundle. Requires
--native-build. Use it if you prefer dependencies to be installed on your
machine rather than on the build server.Exit once the build is queued instead of streaming the build logs. The deployment continues on
the build server. Requires
--native-build.Force building the deployment image locally using your local Docker. This is automatic when self-hosting.
How build logs are shown:
compact (default, a single updating line) or full (every log line).
CI and piped output always use full.Common options
These options are available on most commands.The login profile to use. Defaults to the current profile, which is set by your last
login or switch (initially “default”).Override the default API URL. If not specified, it uses
https://api.trigger.dev. This can also be set via the TRIGGER_API_URL environment variable.The CLI log level to use. Options are
debug, info, log, warn, error, and none. This does not affect the log level of your trigger.dev tasks. Defaults to log.Opt-out of sending telemetry data. This can also be done via the
TRIGGER_TELEMETRY_DISABLED environment variable. Just set it to anything other than an empty string.Self-hosting
When self-hosting, builds are performed locally by default. Once you’ve logged in to your self-hosted instance using the CLI, you can deploy with:TRIGGER_ACCESS_TOKEN and TRIGGER_API_URL environment variables. See the GitHub Actions guide for more details.
