Emergency Hamburg Wiki

Configuration

Where settings live, and which of them are files.

Configuration

Settings come from three places, merged in this order:

  1. base.yml — the defaults for every key, which defines the shape.
  2. config.yml — what this instance overrides, and the only one an operator edits.
  3. The settings table — everything the admin area writes.
Read at: boot
Also read by: the frontend dev server
Holds: port, database, data path
Never holds: anything the admin area can change

What belongs where

A value an operator sets before the wiki starts belongs in config.yml. A value an administrator
changes while it is running belongs in the database, because changing it must not need a restart.

Warning

base.yml is not a user-facing config. It defines the shape of what the other two merge into.

Next