Skip to content

docs: restructure self-hosting kubernetes guide #4481

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nicktrn merged 4 commits into from
Aug 3, 2026
+263 −294
Merged

docs: restructure self-hosting kubernetes guide #4481

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
07ca2d2
docs: restructure self-hosting kubernetes guide into evaluation and p…
nicktrn Aug 3, 2026
05b6f73
docs: correct bundled-component defaults and object-storage config keys
nicktrn Aug 3, 2026
c5f5710
docs: correct helm value paths and fix remaining self-hosting doc errors
nicktrn Aug 3, 2026
bc9a752
docs: correct why an existing secret must carry the provider and coor…
nicktrn Aug 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 4 additions & 6 deletions docs/self-hosting/docker.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -365,12 +365,10 @@ We patch the latest released version line only, so keep an eye on new releases t
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.

<Note>
The bundled ClickHouse now uses the official `clickhouse/clickhouse-server` image. Your existing
data volume carries over automatically. If you previously pinned `CLICKHOUSE_IMAGE_TAG` to a
Bitnami tag (for example `25.7.5-debian-12-r0`), update it to an official image tag such as
`26.2` — Bitnami tags don't exist in the official repository. Note the switch is one-way: the
official image takes ownership of the data files, so rolling back to the Bitnami image requires
manually restoring their previous owner (`chown -R 1001:1001` on the volume).
The bundled ClickHouse uses the official `clickhouse/clickhouse-server` image, and your existing
data volume carries over automatically on upgrade. If you pinned `CLICKHOUSE_IMAGE_TAG` to a
Bitnami tag, switch it to an official tag (for example `26.2`) — Bitnami tags don't exist in the
official repository.
Comment thread
nicktrn marked this conversation as resolved.
</Note>

<Note>
Expand Down
2 changes: 1 addition & 1 deletion docs/self-hosting/env/webapp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ mode: "wide"
| `MAGIC_LINK_SECRET` | Yes | — | Magic link encryption secret. Run: `openssl rand -hex 16` |
| `ENCRYPTION_KEY` | Yes | — | Secret store encryption key. Run: `openssl rand -hex 16` |
| `MANAGED_WORKER_SECRET` | Yes | — | Managed worker secret. Must be set and match supervisor. Run: `openssl rand -hex 32` |
| `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)). |
| `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)). |
| **Domains & ports** | | | |
| `REMIX_APP_PORT` | No | 3030 | Remix app port. |
| `APP_ORIGIN` | Yes | http://localhost:3030 | App origin URL. |
Expand Down
Loading
Loading