Skip to content

Commit d9f4fea

Browse files
authored
docs: restructure self-hosting kubernetes guide (#4481)
Restructures the Kubernetes self-hosting guide around two explicit paths - an **evaluation install** (bundled datastores, one command) and a **production install** (external datastores, your own secrets) - so every configuration decision belongs to one path or the other instead of being a flat list of options with caveats. Also in this pass: - Adds an architecture overview (component-to-`values.yaml` map) and a post-install "verify it" step. - Consolidates the previously scattered upgrade notes into a single collapsible group, and cuts implementation detail and historical asides that no longer apply. - Removes a duplicated object-storage section (two configs in two styles) and trims the Docker ClickHouse note down to what a self-hoster needs to act on.
1 parent 5f29ae4 commit d9f4fea

3 files changed

Lines changed: 263 additions & 294 deletions

File tree

docs/self-hosting/docker.mdx

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -365,12 +365,10 @@ We patch the latest released version line only, so keep an eye on new releases t
365365
You can also lock the versions of the bundled services, for example with `CLICKHOUSE_IMAGE_TAG`. If you do, or if you bring your own ClickHouse via `CLICKHOUSE_URL`, note that Trigger.dev requires ClickHouse 25.8 or newer.
366366
367367
<Note>
368-
The bundled ClickHouse now uses the official `clickhouse/clickhouse-server` image. Your existing
369-
data volume carries over automatically. If you previously pinned `CLICKHOUSE_IMAGE_TAG` to a
370-
Bitnami tag (for example `25.7.5-debian-12-r0`), update it to an official image tag such as
371-
`26.2` — Bitnami tags don't exist in the official repository. Note the switch is one-way: the
372-
official image takes ownership of the data files, so rolling back to the Bitnami image requires
373-
manually restoring their previous owner (`chown -R 1001:1001` on the volume).
368+
The bundled ClickHouse uses the official `clickhouse/clickhouse-server` image, and your existing
369+
data volume carries over automatically on upgrade. If you pinned `CLICKHOUSE_IMAGE_TAG` to a
370+
Bitnami tag, switch it to an official tag (for example `26.2`) — Bitnami tags don't exist in the
371+
official repository.
374372
</Note>
375373
376374
<Note>

docs/self-hosting/env/webapp.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ mode: "wide"
1212
| `MAGIC_LINK_SECRET` | Yes || Magic link encryption secret. Run: `openssl rand -hex 16` |
1313
| `ENCRYPTION_KEY` | Yes || Secret store encryption key. Run: `openssl rand -hex 16` |
1414
| `MANAGED_WORKER_SECRET` | Yes || Managed worker secret. Must be set and match supervisor. Run: `openssl rand -hex 32` |
15-
| `ALLOW_INSECURE_DEFAULT_SECRETS` | No | false | Boot even if a secret is still a known-insecure published default. Temporary escape hatch for values you can't safely rotate yet (see [Secret generation and rotation](/self-hosting/kubernetes#secret-generation-and-rotation)). |
15+
| `ALLOW_INSECURE_DEFAULT_SECRETS` | No | false | Boot even if a secret is still a known-insecure published default. Temporary escape hatch for values you can't safely rotate yet (see [Secrets](/self-hosting/kubernetes#secrets)). |
1616
| **Domains & ports** | | | |
1717
| `REMIX_APP_PORT` | No | 3030 | Remix app port. |
1818
| `APP_ORIGIN` | Yes | http://localhost:3030 | App origin URL. |

0 commit comments

Comments
 (0)