1# gordon preview
2
3Create and manage ephemeral preview environments. Each preview gets its own subdomain, container, and optionally cloned volumes from the base route.
4
5## Commands
6
7### `gordon preview create`
8
9Build, push, and deploy a preview environment.
10
11```bash
12gordon preview create myapp
13gordon preview create myapp --ttl 72h
14gordon preview create myapp --no-build --no-data
15```
16
17| Flag | Description |
18|------|-------------|
19| `--ttl` | Override TTL duration (e.g., `72h`) |
20| `--no-build` | Skip image build (use existing image) |
21| `--no-data` | Skip volume cloning from base route |
22| `--platform` | Target platform for build (default `linux/amd64`) |
23
24### `gordon preview list`
25
26List active preview environments with status and remaining TTL.
27
28```bash
29gordon preview list
30gordon preview list --json
31```
32
33| Flag | Description |
34|------|-------------|
35| `--json` | Output as JSON |
36
37### `gordon preview delete`
38
39Tear down a preview environment and clean up its resources.
40
41```bash
42gordon preview delete myapp-feature-x
43```
44
45### `gordon preview extend`
46
47Extend the TTL of an active preview.
48
49```bash
50gordon preview extend myapp-feature-x
51gordon preview extend myapp-feature-x --ttl 48h
52```
53
54| Flag | Description |
55|------|-------------|
56| `--ttl` | Additional TTL to add (default `24h`) |
57
58## Related
59
60- [Preview Configuration](../config/preview.md)
61- [Deploy](./serve.md#gordon-deploy)