Configuration Reference
CLI
Global Flags
These flags apply to all reel commands:
| Flag | Description | Default |
|---|---|---|
| --agent | Connect to reel agent | false |
| --agent-url | Agent HTTP API URL | http://localhost:8080 |
| --runtime | Container runtime: docker, podman, containerd, crio | auto-detect |
| -v, --verbose | Verbose output (logs instead of spinner) | false |
| -n, --namespace | Kubernetes namespace (agent mode) | default |
Export Flags
| Flag | Description |
|---|---|
| -o, --output | Destination file path |
| --compress | Compression: none, fast, default, better, best |
Delete Flags
delete checkpoint supports bulk cleanup flags; delete layer and delete frame take a single ID.
| Flag | Description | Example |
|---|---|---|
| --all | Delete all checkpoints (with confirmation) | --all |
| --filter | Delete checkpoints matching a glob pattern | --filter "checkpoint_prod-*" |
| --older-than | Delete checkpoints older than a duration (delete checkpoint only) | --older-than 7d |
| -y, --yes | Skip the confirmation prompt | --yes |
Duration format: e.g. 24h (hours), 7d (days)
Output Formats
| Flag | Format | Use Case |
|---|---|---|
| (default) | Human-readable | Terminal |
| -o json | JSON | Automation |
| -o yaml | YAML | GitOps |
Agent
Environment Variables
| Variable | Description | Default |
|---|---|---|
| CLUSTER_NAME | Cluster name used in S3 paths and logs | (empty) |
| LOG_LEVEL | Log verbosity (debug, info, warn, error) | info |
| LOG_FORMAT | Log format (json, console) | console |
| REEL_AGENT | Marks the process as the in-cluster agent (set to 1 by the chart) | 1 |
| REEL_LICENSE | License token, sourced from the license Secret | (unset) |
| REEL_TELEMETRY_DISABLED | Set to true to opt out of startup telemetry | (unset) |
| CLAMAV_ENABLED | Whether the ClamAV malware sidecar is available | true |
| ENABLE_CRIU | Use CRIU checkpoints when the patched CRIU is installed on the node (see install initCriu.enabled) | true |
| HOST_PROC | Mount path for the host /proc filesystem | /host/proc |
| CHECKPOINT_PATH | Directory where checkpoints are written | /var/dumps/checkpoints |
Helm
The values you'll set most often at install:
| Value | Description |
|---|---|
| license.token | License token inline (or use a Secret ref) |
| license.secretRef | Name of an existing Secret holding the license token |
| initCriu.enabled | Install patched CRIU on the node for checkpoint/restore (opt-in) |
| scheduler.maxConcurrentCheckpoints | Concurrent checkpoint captures (default 3) |
| scheduler.maxConcurrentLayers | Concurrent layer captures (default 2) |
| scheduler.operationTimeoutMinutes | Per-operation timeout (default 5) |
See values.yaml for the complete list.