trigger.dev deploy

Deploy your tasks to Trigger.dev Cloud or self-hosted instance.

Usage

npx trigger.dev@latest deploy [options]

How Deployment Works

Common Options

Flag	Description
--env <env>	Deploy to specific environment (default: prod)
--skip-promotion	Deploy without setting as current version
--force-local-build	Build locally with Docker (vs remote build)
--dry-run	Build without deploying
--log-level debug	Verbose output for debugging

Examples

# Deploy to production (default)
npx trigger.dev@latest deploy

# Deploy to staging
npx trigger.dev@latest deploy --env staging

# Deploy to preview branch
npx trigger.dev@latest deploy --env preview

# Deploy without promoting to current version
npx trigger.dev@latest deploy --skip-promotion

# Test build without deploying
npx trigger.dev@latest deploy --dry-run

# Build locally (fallback if remote build fails)
npx trigger.dev@latest deploy --force-local-build

CI Authentication

In CI environments, use the TRIGGER_ACCESS_TOKEN env var:

TRIGGER_ACCESS_TOKEN=xxx npx trigger.dev@latest deploy

Self-hosting

Override API URL:

TRIGGER_API_URL=https://trigger.yourdomain.com npx trigger.dev@latest deploy