---
sidebar_position: 11
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# `lium up`

Create a new pod.

```bash
lium up [EXECUTOR_ID] [OPTIONS]
```

## Arguments

- `EXECUTOR_ID` — Node UUID, HUID, or index from the last [`lium ls`](./ls.md). If omitted, you'll be shown an interactive picker (combined with any filter flags below).

## Options

### Selection & naming

| Flag | Effect |
|------|--------|
| `--name, -n NAME` | Custom pod name (auto-generated if not specified) |
| `--template_id, -t ID` | Specify template ID directly (skips template prompt) |
| `--gpu TYPE` | Filter executors by GPU type (e.g. `H200`, `A6000`) |
| `--count, -c NUM` | Filter by number of GPUs per pod |
| `--country CODE` | Filter executors by ISO country code (`US`, `FR`, …) |
| `--ports, -p NUM` | Require ≥ NUM available ports AND allocate NUM ports |
| `--yes, -y` | Skip confirmation prompt |

### Auto-termination

| Flag | Effect |
|------|--------|
| `--ttl DURATION` | Auto-terminate after duration (e.g. `6h`, `45m`, `2d`) |
| `--until WHEN` | Auto-terminate at local time (`today 23:00`, `tomorrow 01:00`, `2026-05-08 15:30`) |

Use [`lium schedules`](./schedules.md) to view and cancel an existing schedule.

### Container

| Flag | Effect |
|------|--------|
| `--image IMAGE` | Docker image to run (e.g. `pytorch/pytorch:2.0`, `nvidia/cuda:12.0`) |
| `--internal-ports LIST` | Internal ports to expose (comma-separated, e.g. `22,8000,8080`) |
| `-e, --env KEY=VAL` | Environment variable; can be repeated |
| `--entrypoint CMD` | Override container entrypoint |
| `--cmd CMD` | Override container command |
| `--jupyter` | Install Jupyter Notebook (auto-selects an available port) |
| `--ssh-name NAME` | Name for a freshly registered SSH key (default: `cli-<user>@<hostname>`) |

### Volumes

| Flag | Effect |
|------|--------|
| `--volume, -v SPEC` | Volume 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

```bash
# 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

- [`lium ls`](./ls.md) — find a node first
- [`lium templates`](./templates.md) — pick a template
- [`lium volumes`](./volumes.md) — pre-create a volume
- [`lium schedules`](./schedules.md) — manage `--ttl` / `--until` schedules