Skip to main content

lium describe

One pod in full β€” ports, GPU, template, access, billing β€” as a single manifest.

lium describe POD_ID [OPTIONS]

Arguments​

  • POD_ID β€” Pod name, huid, or id. Unlike the pod-targeting commands, this one does not take the numeric index from lium ps.

Options​

FlagEffect
--jsonPrint the manifest as machine-readable JSON

Examples​

lium describe my-pod
lium describe my-pod --json | jq '.ports.ssh_external'

--json carries the whole manifest, grouped into pod, gpu, machine, ports, access, template, storage, and billing. The default table is the readable subset of it β€” pod, GPU, machine, template, ports, SSH and cost β€” so fields like pod id, creation time, location, Jupyter URL and volume encryption are only in the JSON.

Both outputs spell out the port direction, the detail that costs the most time to get wrong: the JSON mapping reads internal -> external and carries that direction as a field, while the table column is labelled ext→int. The SSH port is broken out from the ports left for your own services either way.

A POD_ID that matches nothing exits 5, so a typo cannot read as an empty pod. With --json the command never blocks on the interactive setup prompt: a missing API key surfaces as the JSON error envelope instead.

See also​

  • lium ps β€” list pods and read off a name, huid or id
  • lium ssh β€” open a session on the pod you just described