---
sidebar_position: 21
---

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

Pod backups and restores. Each subcommand operates on a single pod (by HUID or index from `lium ps`).

```bash
lium bk SUBCOMMAND POD_ID [OPTIONS]
```

## Subcommands

| Subcommand | Purpose |
|------------|---------|
| `now` | Trigger an immediate one-off backup |
| `set` | Configure a recurring backup schedule for a pod |
| `show` | Show the backup config and recent backups for a pod |
| `restore` | Restore a backup into a pod |
| `rm` | Delete the backup config for a pod |
| `logs` | Show backup job logs |

### `lium bk now POD_ID`

Trigger a backup right now.

| Flag | Effect |
|------|--------|
| `-n, --name NAME` | Backup name (e.g. `pre-release`) |
| `-d, --description TEXT` | Backup description |

```bash
lium bk now my-pod -n pre-release -d "snapshot before deploy"
```

### `lium bk set POD_ID`

Configure a recurring backup schedule.

| Flag | Effect |
|------|--------|
| `--path PATH` | Backup path (default: `/root`) |
| `--every DURATION` | Frequency (e.g. `1h`, `6h`, `24h`) |
| `--keep DURATION` | Retention (e.g. `1d`, `7d`, `30d`) |
| `-y, --yes` | Skip the confirmation prompt |

```bash
lium bk set my-pod --every 6h --keep 7d
lium bk set my-pod --path /workspace --every 24h --keep 30d -y
```

### `lium bk show POD_ID`

Show the backup config and history for a pod.

```bash
lium bk show my-pod
```

### `lium bk restore POD_ID --id BACKUP_ID`

Restore a backup into a pod.

| Flag | Effect |
|------|--------|
| `--id BACKUP_ID` | **Required.** Backup ID to restore |
| `--to PATH` | Restore path (default: `/root`) |
| `-y, --yes` | Skip confirmation |

```bash
lium bk restore my-pod --id bkp-abc123
lium bk restore my-pod --id bkp-abc123 --to /workspace -y
```

### `lium bk rm POD_ID`

Delete the backup configuration for a pod.

```bash
lium bk rm my-pod -y
```

### `lium bk logs [POD_ID]`

Show backup job logs. Pod ID optional; with `--id`, shows details for one backup.

```bash
lium bk logs                          # Recent jobs across all pods
lium bk logs my-pod                   # Jobs for one pod
lium bk logs --id bkp-abc123          # Details for one backup
```

## See also

- [Backups](/pod-users/backups) — concept guide and schedule policies
- [Restores](/pod-users/restores) — concept guide
- [`lium volumes`](./volumes.md) — for detached storage instead of pod backups