Getting Started

Install Relight and deploy your first app in under 2 minutes.

Install

npm install -g relight-cli

Add a provider

Register at least one provider:

relight providers add

This prompts you to select a provider and paste your credentials. All credentials are stored locally in ~/.relight/config.json - nothing is sent anywhere.

What you need per provider

ProviderWhat to paste
GCPService account key JSON
AWSAccess key ID + secret
AzureTenant ID, client ID, client secret, subscription ID
CloudflareAPI token + Account ID
DigitalOceanAPI token

Deploy

From a directory with a Dockerfile:

relight deploy myapp .

Relight builds the image, pushes it to your provider’s registry, and deploys. You get a URL.

If you omit the name, one is auto-generated. If you omit the path, the current directory is used.

Open

relight open myapp

Opens the app URL in your default browser.

Check status

relight apps          # list all apps
relight ps myapp      # container status
relight logs myapp    # stream live logs
relight cost myapp    # estimated cost

What happens next

Your app scales to zero when idle (on GCP and Azure - AWS has a ~$2.55/mo idle minimum). The next request wakes it. Cold starts are 3-5 seconds on GCP, 2-5 seconds on Azure, and instant on AWS.