Skip to main content

lium up

Create a new pod.

lium up [NODE_ID] [OPTIONS]

Arguments​

  • NODE_ID — Node UUID, HUID, or index from the last lium ls. If omitted, you'll be shown an interactive picker (combined with any filter flags below).

Options​

Selection & naming​

FlagEffect
--name, -n NAMECustom pod name (auto-generated if not specified)
--template_id, -t IDSpecify template ID directly (skips template prompt)
--gpu TYPEFilter nodes by GPU type (e.g. H200, A6000)
--count, -c NUMFilter by number of GPUs per pod
--country CODEFilter nodes by ISO country code (US, FR, …)
--ports, -p NUMRequire ≥ NUM available ports AND allocate NUM ports
--yes, -ySkip confirmation prompt

Auto-termination​

FlagEffect
--ttl DURATIONAuto-terminate after duration (e.g. 6h, 45m, 2d)
--until WHENAuto-terminate at local time (today 23:00, tomorrow 01:00, 2026-05-08 15:30)

Use lium schedules to view and cancel an existing schedule.

Container​

FlagEffect
--image IMAGEDocker image to run (e.g. pytorch/pytorch:2.0, nvidia/cuda:12.0)
--internal-ports LISTInternal ports to expose (comma-separated, e.g. 22,8000,8080)
-e, --env KEY=VALEnvironment variable; can be repeated
--entrypoint CMDOverride container entrypoint
--cmd CMDOverride container command
--jupyterInstall Jupyter Notebook (auto-selects an available port)
--ssh-name NAMEName for a freshly registered SSH key (default: cli-<user>@<hostname>)

Volumes​

FlagEffect
--volume, -v SPECVolume spec — see below

Volume spec forms:

  • id:<HUID> — attach an existing volume by HUID
  • new:name=<NAME>[,desc=<DESC>] — create and attach a new volume

Examples​

# Basic
lium up                                       # Interactive picker
lium up cosmic-hawk-f2                        # Specific node by HUID
lium up 1                                     # Node #1 from last ls
lium up --name dev-pod                        # Custom name

# Filtering nodes
lium up --gpu H200
lium up --gpu A6000 -c 2
lium up --gpu H200 --country FR
lium up --ports 5

# Auto-terminate
lium up --gpu H200 --ttl 6h                   # Stop after 6h
lium up --gpu H200 --until "tomorrow 09:00"   # Stop tomorrow morning

# Container customization
lium up 1 --image pytorch/pytorch:2.0
lium up 1 --image my-image -e API_KEY=xyz -e DEBUG=1
lium up 1 --internal-ports 22,8000,8080
lium up 1 --jupyter                           # Spin up with Jupyter

# Volumes
lium up 1 --volume id:brave-fox-3a
lium up 1 --volume new:name=my-data,desc="Training data"

# Direct template + skip prompt
lium up 1 --template_id abc123
lium up --gpu H200 --yes

See also​