Deployments

A deployment is a running instance of a service. You can deploy, redeploy, stop, list historical deployments, and stream live logs.

The deploy command can be shortened to d:

edge d up api

All deployment commands require a workspace, project, and environment.

up

Deploy a service. If the service has never been deployed, a new deployment is created (POST). If it has been deployed before and you want to trigger a fresh deploy, the same command re-deploys it (PUT).

edge deploy up <svc-slug>

edge deploy up api

Example output

✓ Deployment started: dep-01j2k3... (status: pending)

JSON output

edge deploy up api --json

{
  "id": "dep-01j2k3...",
  "slug": "dep-01j2k3...",
  "status": "pending",
  "service_id": "svc-01j2k3...",
  "created_at": "2025-06-01T12:00:00Z",
  "updated_at": "2025-06-01T12:00:00Z"
}

down

Stop a running service (undeploy).

edge deploy down <svc-slug>

edge deploy down api

The service's resources are freed but its configuration is preserved. Run edge deploy up to start it again.

list

List all deployments for a service, ordered from newest to oldest.

edge deploy list <svc-slug>
edge deploy list api --json

Example output

SLUG              STATUS     CREATED AT
dep-01j2k3...     running    2025-06-01T12:00:00Z
dep-01j2k2...     stopped    2025-05-28T09:15:00Z
dep-01j2k1...     failed     2025-05-20T17:30:00Z

logs

Stream live logs from a deployment via Server-Sent Events (SSE).

edge deploy logs <svc-slug>
edge deploy logs <svc-slug> --deployment <dep-slug>

By default, logs are streamed from the latest deployment. Pass --deployment to target a specific one.

Press Ctrl+C to stop streaming.

Flags

Flag	Description
`--deployment`	Deployment slug to stream from (defaults to latest)
`--follow`, `-f`	Follow log output (currently implicit — streaming is always live)

Example

# Stream latest deployment logs
edge deploy logs api

# Stream a specific deployment
edge deploy logs api --deployment dep-01j2k3...

→ Streaming logs for deployment dep-01j2k3...
2025-06-01T12:00:05Z Starting server on :8080
2025-06-01T12:00:05Z Connected to database
2025-06-01T12:00:06Z Listening for requests

Log streaming uses the HTTP text/event-stream protocol. The connection stays open until you press Ctrl+C or the deployment ends.

Deployments

On this page