Skip to main content

lium ps

List your active pods.

lium ps [POD_ID] [OPTIONS]

Arguments​

  • POD_ID — Optional pod name, index, or id. When given, shows just that pod.

Options​

FlagEffect
--format FORMATOutput format: table (default) or json

Examples​

lium ps                   # All your pods
lium ps my-pod            # A single pod by name/index/id
lium ps --format json     # JSON output

Naming a POD_ID that matches nothing exits 5, in both table and json format — the same rule lium rm follows. An unfiltered lium ps on an account with no pods is not a failure: it warns No active pods as a table, prints [] with --format json, and exits 0 either way.

The numeric index in the first column is reused by lium ssh, lium exec, lium scp, lium rsync, and lium rm.

See also​