Skip to main content
Display detailed information about a service including all its containers, their status, and machine placement.

​
Usage

uc service inspect SERVICE

​
Arguments

​
SERVICE
string
required
The name or ID of the service to inspect

​
Description

The inspect command provides a detailed view of a service, showing:
  • Service ID and name
  • Service mode (replicated or global)
  • List of all containers with their details:
    • Container ID
    • Image being used
    • Creation time
    • Current status
    • IP address on the mesh network
    • Machine where it’s running
Containers are sorted by creation time with newest first, which is useful for identifying recent deployments.

​
Examples

​
Inspect a service by name

uc service inspect my-app
Output: 
Service ID: 1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p
Name:       my-app
Mode:       replicated

CONTAINER ID   IMAGE               CREATED         STATUS      IP ADDRESS      MACHINE
a1b2c3d4e5f6   nginx:alpine        2 minutes ago   Up 2 min    10.210.1.5      hetzner-server
f6e5d4c3b2a1   nginx:alpine        10 minutes ago  Up 10 min   10.210.0.3      oracle-vm

​
Inspect a global service

uc service inspect caddy
Output: 
Service ID: 9z8y7x6w5v4u3t2s1r0q9p8o7n6m5l4k
Name:       caddy
Mode:       global

CONTAINER ID   IMAGE           CREATED         STATUS      IP ADDRESS      MACHINE
x9y8z7w6v5u4   caddy:2.8.4     5 minutes ago   Up 5 min    10.210.1.2      hetzner-server
u4v5w6z7y8x9   caddy:2.8.4     5 minutes ago   Up 5 min    10.210.0.2      oracle-vm

​
Check container IP addresses

Use inspect to find the mesh network IP addresses of containers for direct communication: 
uc service inspect database
The IP ADDRESS column shows the internal mesh IP (e.g., 10.210.X.Y) that other containers can use to connect to this service.

​
Output Fields

  • CONTAINER ID: Short container ID (first 12 characters)
  • IMAGE: Docker image used for the container
  • CREATED: How long ago the container was created
  • STATUS: Current container state (Up, Exited, etc.)
  • IP ADDRESS: Mesh network IP address for direct container communication
  • MACHINE: Name of the machine running this container
The IP ADDRESS field will be empty for containers that are not running or use host networking mode.

Build docs developers (and LLMs) love

Get started for freeTalk to us