diff --git a/Example-Configurations.md b/Example-Configurations.md index 6724b57..18f9137 100644 --- a/Example-Configurations.md +++ b/Example-Configurations.md @@ -6,6 +6,18 @@ You can find your existing configuration file in the following locations, depend - `/data/controld/` - on some Ubiqiti devices - `/jffs/controld/` - on DD-WRT, Asus merlin, FreshTomato +## Important: Enable Local Config Mode +If you used the default 1 liner installer to get `ctrld` on your device, or used the `--cd RESOLVER_ID` flag to start the service, you will see the following line at the top of the config file on disk: +``` +# AUTO-GENERATED VIA CD FLAG - DO NOT MODIFY +``` + +In this mode, the config is automatically re-rendered every time the service starts, so your changes will be overwritten. In order to use `ctrld` in local config mode, execute the following commands: +- `ctrld stop` - this will stop the service +- `ctrls start` - this will start the service in "local config mode" which enforces the config on disk + +Now you can make changes to it, and execute `ctrld restart` command to enforce your changes. + ## Simplest The simplest possible configuration looks like this. The following config does the following: - Spawn a single DNS listener on `0.0.0.0` (all interfaces) and port `53`