From 3bc010a6d9f3ece49e96a0308777d10f7faa2483 Mon Sep 17 00:00:00 2001 From: Shivaram Lingamneni Date: Fri, 13 Mar 2026 16:50:17 -0400 Subject: [PATCH] document limitations of environment overrides --- docs/MANUAL.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/MANUAL.md b/docs/MANUAL.md index 5797935e..59f0626b 100644 --- a/docs/MANUAL.md +++ b/docs/MANUAL.md @@ -179,6 +179,10 @@ Ergo can also be configured using environment variables, using the following tec However, settings that were overridden using this technique cannot be rehashed --- changing them will require restarting the server. +Due to implementation details, this technique has some limitations. Here are the known issues: + +1. `opers` must be overridden in its entirety with `ERGO__OPERS` (you cannot override the properties of individual operators, e.g. with `ERGO__OPERS__ADMIN__PASSWORD`) +1. `accounts.auth-script` and `server.ip-check-script` do not work as expected (see [#2275](https://github.com/ergochat/ergo/issues/2275) for workarounds). ## Productionizing with systemd