Updated Example Configurations (markdown)

Yegor S
2023-11-07 12:03:03 -05:00
parent 63bcef0438
commit 2b2dfe6b43

@@ -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`