docs(cli): update index for v2.30.0

Add preview, volumes to management commands table. Sort commands
alphabetically. Add auth login/status/show-token/logout and preview/
volumes to quick reference. Remove dead password hash example.

commit: 83e8199528dffffd708e280fc51917246246e240
author: brice · 6mo ago · 2026-03-28 07:42 UTC
parent: 3ee801c
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +27 -12

M docs/cli/index.md +27 -12


@@ -23,23 +23,25 @@ Management commands run locally through in-process services by default. Add `--r
23	23
24	24		\| Command \| Description \| Documentation \|
25	25		\|---------\|-------------\|---------------\|
26		-	\| `gordon routes` \| Manage routes \| [routes](./routes.md) \|
27	26		\| `gordon attachments` \| Manage container attachments \| [attachments](./attachments.md) \|
28		-	\| `gordon secrets` \| Manage secrets \| [secrets](./secrets.md) \|
29		-	\| `gordon deploy` \| Manually deploy or redeploy a route \| [serve](./serve.md#gordon-deploy) \|
30		-	\| `gordon restart` \| Restart a running container \| [restart](./restart.md) \|
	27	+	\| `gordon autoroute` \| Manage auto-route domain allowlist \| [autoroute](./autoroute.md) \|
	28	+	\| `gordon backups` \| Manage database backups \| [backup](./backup.md) \|
31	29		\| `gordon bootstrap` \| Configure a route, attachments, and secrets for an app \| [bootstrap](./bootstrap.md) \|
	30	+	\| `gordon config show` \| Show server configuration \| [config](./config.md) \|
	31	+	\| `gordon deploy` \| Manually deploy or redeploy a route \| [serve](./serve.md#gordon-deploy) \|
	32	+	\| `gordon images` \| List and prune images \| [images](./images.md) \|
	33	+	\| `gordon logs` \| Display Gordon process or container logs \| [serve](./serve.md#gordon-logs) \|
	34	+	\| `gordon networks list` \| List Gordon-managed Docker networks \| [networks](./networks.md) \|
	35	+	\| `gordon preview` \| Create or manage preview environments \| [preview](../config/preview.md) \|
32	36		\| `gordon push` \| Tag, push, and optionally deploy an image \| [push](./push.md) \|
33	37		\| `gordon attachments push` \| Build/push attachment images to registry \| [attachments](./attachments.md) \|
34		-	\| `gordon rollback` \| Roll back to a previous image tag \| [rollback](./rollback.md) \|
35	38		\| `gordon reload` \| Reload configuration and sync containers \| [serve](./serve.md#gordon-reload) \|
36		-	\| `gordon logs` \| Display Gordon process or container logs \| [serve](./serve.md#gordon-logs) \|
	39	+	\| `gordon restart` \| Restart a running container \| [restart](./restart.md) \|
	40	+	\| `gordon rollback` \| Roll back to a previous image version \| [rollback](./rollback.md) \|
	41	+	\| `gordon routes` \| Manage routes \| [routes](./routes.md) \|
	42	+	\| `gordon secrets` \| Manage secrets \| [secrets](./secrets.md) \|
37	43		\| `gordon status` \| Show Gordon server status \| [status](./status.md) \|
38		-	\| `gordon backups` \| Manage database backups \| [backup](./backup.md) \|
39		-	\| `gordon images` \| List and prune images \| [images](./images.md) \|
40		-	\| `gordon config show` \| Show server configuration \| [config](./config.md) \|
41		-	\| `gordon networks list` \| List Gordon-managed Docker networks \| [networks](./networks.md) \|
42		-	\| `gordon autoroute` \| Manage auto-route domain allowlist \| [autoroute](./autoroute.md) \|
	44	+	\| `gordon volumes` \| Manage volumes \| - \|
43	45
44	46		## Client Commands
45	47

@@ -102,10 +104,13 @@ gordon images prune --runtime-only
102	104		gordon images prune --keep 3
103	105
104	106		# Authentication
	107	+	gordon auth login --remote https://gordon.example.com --token $TOKEN
	108	+	gordon auth status
	109	+	gordon auth show-token
	110	+	gordon auth logout
105	111		gordon auth token generate --subject ci-bot --expiry 0
106	112		gordon auth token list
107	113		gordon auth token revoke <token-id>
108		-	gordon auth password hash
109	114		gordon auth internal
110	115
111	116		# Routes

@@ -129,6 +134,16 @@ gordon remotes add prod https://gordon.mydomain.com --token $TOKEN
129	134		gordon remotes list
130	135		gordon remotes use prod
131	136
	137	+	# Preview environments
	138	+	gordon preview create app.example.com --branch feature-x
	139	+	gordon preview list
	140	+	gordon preview extend app.example.com --branch feature-x
	141	+	gordon preview delete app.example.com --branch feature-x
	142	+
	143	+	# Volumes
	144	+	gordon volumes list
	145	+	gordon volumes prune
	146	+
132	147		# Auto-route allowlist
133	148		gordon autoroute allow list
134	149		gordon autoroute allow add example.com

 | Command | Description | Documentation |
 |---------|-------------|---------------|
-| `gordon routes` | Manage routes | [routes](./routes.md) |
 | `gordon attachments` | Manage container attachments | [attachments](./attachments.md) |
-| `gordon secrets` | Manage secrets | [secrets](./secrets.md) |
+| `gordon autoroute` | Manage auto-route domain allowlist | [autoroute](./autoroute.md) |
-| `gordon deploy` | Manually deploy or redeploy a route | [serve](./serve.md#gordon-deploy) |
+| `gordon backups` | Manage database backups | [backup](./backup.md) |
-| `gordon restart` | Restart a running container | [restart](./restart.md) |
 | `gordon bootstrap` | Configure a route, attachments, and secrets for an app | [bootstrap](./bootstrap.md) |
+| `gordon config show` | Show server configuration | [config](./config.md) |
+| `gordon deploy` | Manually deploy or redeploy a route | [serve](./serve.md#gordon-deploy) |
+| `gordon images` | List and prune images | [images](./images.md) |
+| `gordon logs` | Display Gordon process or container logs | [serve](./serve.md#gordon-logs) |
+| `gordon networks list` | List Gordon-managed Docker networks | [networks](./networks.md) |
+| `gordon preview` | Create or manage preview environments | [preview](../config/preview.md) |
 | `gordon push` | Tag, push, and optionally deploy an image | [push](./push.md) |
 | `gordon attachments push` | Build/push attachment images to registry | [attachments](./attachments.md) |
-| `gordon rollback` | Roll back to a previous image tag | [rollback](./rollback.md) |
 | `gordon reload` | Reload configuration and sync containers | [serve](./serve.md#gordon-reload) |
-| `gordon logs` | Display Gordon process or container logs | [serve](./serve.md#gordon-logs) |
+| `gordon restart` | Restart a running container | [restart](./restart.md) |
+| `gordon rollback` | Roll back to a previous image version | [rollback](./rollback.md) |
+| `gordon routes` | Manage routes | [routes](./routes.md) |
+| `gordon secrets` | Manage secrets | [secrets](./secrets.md) |
 | `gordon status` | Show Gordon server status | [status](./status.md) |
-| `gordon backups` | Manage database backups | [backup](./backup.md) |
+| `gordon volumes` | Manage volumes | - |
-| `gordon images` | List and prune images | [images](./images.md) |
-| `gordon config show` | Show server configuration | [config](./config.md) |
-| `gordon networks list` | List Gordon-managed Docker networks | [networks](./networks.md) |
-| `gordon autoroute` | Manage auto-route domain allowlist | [autoroute](./autoroute.md) |
 ## Client Commands
 gordon images prune --keep 3
 # Authentication
+gordon auth login --remote https://gordon.example.com --token $TOKEN
+gordon auth status
+gordon auth show-token
+gordon auth logout
 gordon auth token generate --subject ci-bot --expiry 0
 gordon auth token list
 gordon auth token revoke <token-id>
-gordon auth password hash
 gordon auth internal
 # Routes
 gordon remotes list
 gordon remotes use prod
+# Preview environments
+gordon preview create app.example.com --branch feature-x
+gordon preview list
+gordon preview extend app.example.com --branch feature-x
+gordon preview delete app.example.com --branch feature-x
+# Volumes
+gordon volumes list
+gordon volumes prune
 # Auto-route allowlist
 gordon autoroute allow list
 gordon autoroute allow add example.com