From 56dd99eb3eee7953c869eb840c7526730171d072 Mon Sep 17 00:00:00 2001 From: Brendan Jackman Date: Sun, 28 Dec 2025 17:58:21 +0100 Subject: [PATCH] docs: clarify scope of config file and environment variables I got pretty confused about why I can't set auth.method from the config file (and also why there were no docs saying what the JSON/YAML/etc key would even be). Document that this doesn't work to try to prevent future confusion here. Caveat: I wrote this documentation by hand, but I did not actually read the code carefully enough to have figured this out myself. I am trusting the claims made by an LLM coding agent (which do at least seem to match empirical evidence). --- cmd/root.go | 5 +++++ www/docs/cli/filebrowser.md | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/cmd/root.go b/cmd/root.go index dd91c1b2..13bc3192 100644 --- a/cmd/root.go +++ b/cmd/root.go @@ -135,6 +135,11 @@ file named .filebrowser.{json, toml, yaml, yml} in the following directories: - $HOME/ - /etc/filebrowser/ +**Note:** Only the options listed below can be set via the config file or +environment variables. Other configuration options live exclusively in the +database and so they must be set by the "config set" or "config +import" commands. + The precedence of the configuration values are as follows: - Flags diff --git a/www/docs/cli/filebrowser.md b/www/docs/cli/filebrowser.md index 8383ec97..e2390238 100644 --- a/www/docs/cli/filebrowser.md +++ b/www/docs/cli/filebrowser.md @@ -26,6 +26,11 @@ file named .filebrowser.{json, toml, yaml, yml} in the following directories: - $HOME/ - /etc/filebrowser/ +**Note:** Only the options listed below can be set via the config file or +environment variables. Other configuration options live exclusively in the +database and so they must be set by the "config set" or "config +import" commands. + The precedence of the configuration values are as follows: - Flags