From 504b58ecf6ad3bac84b19b829dc35458880cd790 Mon Sep 17 00:00:00 2001 From: Maurice Date: Sat, 24 Oct 2026 23:18:34 +0200 Subject: [PATCH] Correct the Helm env key note, add the Recreate update strategy and the pre-migrate copy --- wiki/Install-Helm.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/wiki/Install-Helm.md b/wiki/Install-Helm.md index 4125a0c35..dd38efbc5 100644 --- a/wiki/Install-Helm.md +++ b/wiki/Install-Helm.md @@ -112,6 +112,9 @@ env: # TZ: "Europe/Berlin" # timezone for logs, reminders, cron jobs # LOG_LEVEL: "info" # "info" = concise, "debug" = verbose # TREK_WIKI_DIR: "/app/wiki" # where /help reads its docs from; leave unset (the image ships them) + # DEFAULT_LANGUAGE: "en" # fallback language on the login page + # MCP_MAX_SESSION_PER_USER: "20" # max concurrent MCP sessions per user + # GOOGLE_LIST_DATA_BASE: "" # base URL of a list-data service for pasted list URLs # ALLOWED_ORIGINS: "https://trek.example.com" # APP_URL: "https://trek.example.com" # FORCE_HTTPS: "false" # enable HTTPS redirect + HSTS; set TRUST_PROXY for correct client IPs @@ -146,7 +149,7 @@ env: # VAPID_SUBJECT: "mailto:admin@example.com" # Web Push contact; defaults to APP_URL when it is https ``` -> **Note:** The chart only passes on the keys its ConfigMap declares. `DEFAULT_LANGUAGE`, `MCP_MAX_SESSION_PER_USER` (although `values.yaml` lists it in a comment), `FILE_UPLOAD_LIMIT_MB` and `RESTORE_FROM_BACKUP` are not among them, so a value under `env:` is dropped and the default stays. Patch such a variable onto the Deployment if you need it. See [Environment-Variables](Environment-Variables#default_language--supported-codes) for the language codes. +> **Note:** The chart only passes on the keys its ConfigMap declares. `FILE_UPLOAD_LIMIT_MB` and `RESTORE_FROM_BACKUP` are not among them, so a value under `env:` is dropped and the default stays. Put such a variable in `extraEnv` (see below) instead. See [Environment-Variables](Environment-Variables#default_language--supported-codes) for the language codes. ### Sensitive Variables (`secretEnv`) @@ -163,9 +166,10 @@ secretEnv: AMAP_API_KEY: "" # optional; Amap Web 服务 key for place search in mainland China AMAP_API_SECRET: "" # optional; the signing secret of that key, only when signing is on VAPID_PRIVATE_KEY: "" # optional; Web Push private half, only together with env.VAPID_PUBLIC_KEY + SMTP_PASS: "" # optional; password of your SMTP account ``` -Alternatively, use `generateEncryptionKey: true` to let the chart generate and manage the encryption key, or point `existingSecret` / `existingSecretKey` at an existing Kubernetes Secret. +Alternatively, use `generateEncryptionKey: true` to let the chart generate and manage the encryption key, or point `existingSecret` / `existingSecretKey` at an existing Kubernetes Secret. A Secret you bring yourself can carry any of the keys above by the same names, `SMTP_PASS` included. Every value the chart writes into its Secret is quoted, so a password such as `12345` or a value like `true` reaches the container as the text you typed. @@ -175,6 +179,8 @@ Every value the chart writes into its Secret is quoted, so a password such as `1 ### Persistent Storage +The data PVC holds the database, the plugins you install and the automatic `pre-migrate--