Deploy

Basic deploy

relight deploy myapp .

Builds a Docker image from the Dockerfile in the current directory, pushes it to your provider’s registry, and deploys.

Options

relight deploy [name] [path]
  --compute <name>              # Provider for compute
  -t, --tag <tag>               # Image tag (default: deploy-<timestamp>)
  -e, --env KEY=VALUE ...       # Set env vars at deploy time
  --regions <hints>             # Comma-separated regions (wnam,enam,weur,apac...)
  -i, --instances <n>           # Instances per region
  --port <port>                 # Container port (default: 8080)
  --sleep <duration>            # Idle timeout before sleeping (default: 30s)
  --instance-type <type>        # Size preset (lite, base, standard, large)
  --vcpu <n>                    # vCPU allocation (0.0625, 0.5, 1, 2)
  --memory <mb>                 # Memory in MiB (256, 512, 1024)
  --disk <mb>                   # Disk in MB (2000, 5000)
  --dns <name>                  # Provider for DNS records
  --no-observability            # Disable Workers observability (CF only)
  --json                        # JSON output
  -y, --yes                     # Skip confirmation

Name and path

• If name is omitted, Relight auto-generates one
• If path is omitted, uses the current directory
• path should point to a directory containing a Dockerfile

Provider selection

If you have multiple providers configured, Relight uses your default. Override with:

relight deploy myapp . --compute gcp
relight deploy myapp . --compute aws
relight deploy myapp . --compute azure

Setting env vars at deploy time

relight deploy myapp . -e API_KEY=sk-xxx -e NODE_ENV=production

These are set before the container starts. You can also set them after deploy with relight config set.

Regions

relight deploy myapp . --regions enam,weur

Region hints are translated to the closest provider region. Run relight regions to see available hints. On GCP, AWS, and Azure, the first deploy prompts you to pick a region interactively.

Resource sizing

relight deploy myapp . --vcpu 1 --memory 512
# or use presets:
relight deploy myapp . --instance-type standard

Sleep behavior

By default, apps sleep after 30 seconds of no traffic:

relight deploy myapp . --sleep 5m    # sleep after 5 minutes idle
relight deploy myapp . --sleep never # always on

Redeploying

Run relight deploy again with the same name to update:

relight deploy myapp .    # rebuilds and redeploys

The previous version is replaced. Relight does not keep release history (yet).

What deploy creates per provider

Provider	Registry	Compute	URL format
GCP	Artifact Registry	Cloud Run	myapp-abc123.run.app
AWS	ECR	App Runner	myapp.us-east-1.awsapprunner.com
Azure	ACR	Container Apps	myapp.eastus.azurecontainerapps.io