Skip to main content
Start all containers of one or more previously stopped services across all machines in the cluster.

Usage

uc start SERVICE [SERVICE...]

Arguments

SERVICE
string[]
required
Names or IDs of services to start. Can specify multiple services.

Examples

Start a service

uc start web

Start multiple services

uc start web api worker

How It Works

The command starts all containers that were previously created for the specified service(s). Containers are started in parallel across all machines.

Output

Starting service web
✓ Started 3 containers

State Restoration

When you start a service, containers resume with:
  • Same configuration
  • Same image
  • Same environment variables
  • Same volume mounts
  • Same network settings
This is different from uc run or uc deploy, which can create new containers with updated configuration.

Common Workflow

Stop a service temporarily:
uc stop web
Do maintenance, then start it again:
uc start web

Use Cases

Resume After Maintenance

After performing maintenance:
uc start web api

Restart Development Services

Start services you stopped to save resources:
uc start dev-api staging-worker

Recover from Issues

If you manually stopped containers:
uc start web

Starting vs Running

  • uc start SERVICE - Start existing stopped containers
  • uc run IMAGE - Create and start new containers from an image
  • uc deploy - Create or update containers from Compose file
Use uc start only for containers that were previously created and stopped.

Error Cases

Service Not Found

If the service doesn’t exist:
Error: service 'web' not found

Containers Already Running

If containers are already running, the command has no effect:
Starting service web
✓ Started 0 containers (already running)

Build docs developers (and LLMs) love