From 2b2dfe6b431e3b67543670deb9873de075a3f03c Mon Sep 17 00:00:00 2001 From: Yegor S Date: Tue, 7 Nov 2023 12:03:03 -0500 Subject: [PATCH] Updated Example Configurations (markdown) --- Example-Configurations.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) 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`