Every setting can be given as an environment variable (closes #128)

Conversation 5 Commits 3 Files Changed 7

+448 -126

3 Commits

Author	SHA1	Message	Date
sneak	9b49a9d5b3	Say that a config file's env: section overrides the environment (closes #128 ) check / check (push) Successful in 3m22s Details A variable named in the config file's env: section is set while the file loads, so it overrides both the environment the process was started with and the file's own key. README.md and the config.example.yml header said only that a variable wins over the file; they now state this exception where the precedence is given. Model: opus-5-5	2026-09-28 11:10:23 +00:00
sneak	a7947da6f1	Take every setting from PIXA_ variables and PORT (closes #128 ) Each config key can now be set by PIXA_ plus the key in upper case ("." written as "_"), and the port by PORT. One list pairs keys with variables; the typed getters read a present variable, even an empty one, before the config file, so every existing check covers it, and errors a variable can reach name both the key and the variable. An empty string for blocked_networks or trusted_proxies is now an empty list, as for allowlist_hosts. The image no longer bakes in config.docker.yml or passes --config, and its HEALTHCHECK probes ${PORT:-8080}; the config file is looked for under /etc/pixa rather than /etc/pixad, so a file mounted at /etc/pixa/config.yml is still read. Model: opus-5-5	2026-09-28 11:10:23 +00:00
sneak	7dc0ad7902	test: every setting from its environment variable (closes #128 ) Tests, written before the change, for the PIXA_ variables and PORT: every key set from the environment with no config file, PORT over the file's port, a list variable replacing the file's list, an empty variable as a set value, invalid values aborting startup naming the variable, and the signing key and metrics password never printed. All fail until the change lands, except the check that a config file alone behaves as before. TestMain unsets PORT and every PIXA_ variable so the shell running the tests cannot change their result. Model: opus-5-5	2026-09-28 11:10:07 +00:00

Author

SHA1

Message

Date

sneak

9b49a9d5b3

Say that a config file's env: section overrides the environment (closes #128 )

check / check (push) Successful in 3m22s

Details

A variable named in the config file's env: section is set while the
file loads, so it overrides both the environment the process was started
with and the file's own key. README.md and the config.example.yml header
said only that a variable wins over the file; they now state this
exception where the precedence is given.

Model: opus-5-5

2026-09-28 11:10:23 +00:00

sneak

a7947da6f1

Take every setting from PIXA_ variables and PORT (closes #128 )

Each config key can now be set by PIXA_ plus the key in upper case
("." written as "_"), and the port by PORT. One list pairs keys with
variables; the typed getters read a present variable, even an empty
one, before the config file, so every existing check covers it, and
errors a variable can reach name both the key and the variable. An
empty string for blocked_networks or trusted_proxies is now an empty
list, as for allowlist_hosts. The image no longer bakes in
config.docker.yml or passes --config, and its HEALTHCHECK probes
${PORT:-8080}; the config file is looked for under /etc/pixa rather
than /etc/pixad, so a file mounted at /etc/pixa/config.yml is still
read.

Model: opus-5-5

2026-09-28 11:10:23 +00:00

sneak

7dc0ad7902

test: every setting from its environment variable (closes #128 )

Tests, written before the change, for the PIXA_ variables and PORT:
every key set from the environment with no config file, PORT over the
file's port, a list variable replacing the file's list, an empty
variable as a set value, invalid values aborting startup naming the
variable, and the signing key and metrics password never printed. All
fail until the change lands, except the check that a config file alone
behaves as before. TestMain unsets PORT and every PIXA_ variable so the
shell running the tests cannot change their result.

Model: opus-5-5

2026-09-28 11:10:07 +00:00

Every setting can be given as an environment variable (closes #128) #131