Skip to main content
List all services running in your cluster, showing their mode, replica count, images, and endpoints.

​
Usage

uc service ls
Alias: uc service list

​
Output

The command displays a table with the following columns:
  • NAME - Service name
  • MODE - Replication mode (replicated or global)
  • REPLICAS - Number of running containers
  • IMAGE - Container image(s) used by the service
  • ENDPOINTS - Public endpoints for accessing the service
If services have duplicate names, an ID column is also shown to differentiate them.

​
Examples

​
List all services

uc service ls
Example output: 
NAME     MODE         REPLICAS   IMAGE            ENDPOINTS
web      replicated   3          nginx:latest     https://web.abc123.uncld.dev
api      replicated   2          myapp:v2         https://api.abc123.uncld.dev
db       replicated   1          postgres:16      
caddy    global       2          caddy:latest     (custom Caddy config)

​
Understanding the Output

​
Service Mode

  • replicated - Service has a specific number of containers that can run on any suitable machines
  • global - Service runs exactly one container on every machine in the cluster

​
Replica Count

For replicated services, this shows the number of containers currently running. For global services, it equals the number of machines in the cluster.

​
Images

Shows the container image(s) used by the service. If containers use different images (for example, during a rolling update), multiple images are listed.

​
Endpoints

Shows public URLs for accessing the service:
  • HTTPS URLs - Services published via Caddy reverse proxy
  • (custom Caddy config) - Services using a custom Caddyfile
  • Empty - Services with no public endpoints (internal only)

​
Filtering Services

To filter services, use standard command-line tools: 
uc service ls | grep web

​
Use Cases

​
Check deployment status

After deploying, verify all services are running: 
uc service ls

​
Monitor replica counts

Check how many replicas are running for each service: 
uc service ls

​
Find service endpoints

Get the URL for accessing a service: 
uc service ls | grep myapp

Build docs developers (and LLMs) love

Get started for freeTalk to us