Skip to main content

lium ls

List available GPU nodes.

lium ls [OPTIONS]

Optionsโ€‹

FlagEffect
--gpu TYPEFilter by GPU type (H100, A100, RTX4090, โ€ฆ)
--count NExact GPU count to match (e.g. 1, 8)
--min-cuda VERSIONMinimum CUDA version supported by the node (e.g. 12.4)
--lat LATLatitude for distance filtering
--lon LONLongitude for distance filtering
--max-distance MILESMaximum distance in miles from --lat/--lon
--sort FIELDSort by download (default), upload, price_gpu, price_total, loc, id, or gpu
--limit NLimit the number of rows shown
--format FORMATOutput format: table (default) or json

Examplesโ€‹

lium ls                    # List all nodes
lium ls --gpu H100 # Only H100 GPUs
lium ls --min-cuda 12.4 # Only nodes supporting CUDA 12.4 or higher
lium ls --sort price_gpu # Cheapest $/GPUยทh first
lium ls --limit 10 # Show only the first 10 rows
lium ls --format json # JSON output

Pareto-optimal choices in the table are marked with โ˜….

Tier columnโ€‹

Each node shows its Tier, so you can see the interruption risk before renting:

  • secure โ€” the default. If the rental is interrupted, the provider is penalized (their rental fee is withheld), so these nodes are the stable choice.
  • spot โ€” the provider can reclaim the node at any time with no penalty, and you are not compensated if the pod is interrupted. Use spot for cheaper, interruptible, fault-tolerant workloads.

With --format json, the same value is exposed as the tier field on each node ("spot", "secure", or null when unknown).

See Node Tier: Secure vs Spot for the full comparison.

See alsoโ€‹

  • lium up โ€” create a pod on a listed node
  • lium ps โ€” list pods you already own