CalvinBackup/ctrld
1
0
Fork 0
mirror of https://github.com/Control-D-Inc/ctrld.git synced 2026-02-03 22:18:39 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated Example Configurations (markdown)

Cuong Manh Le
2024-09-14 22:48:05 +07:00
parent 62da258acf
commit 8e758e023e
1 changed files with 3 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
Example-Configurations.md

@@ -14,14 +14,15 @@ If you used the default 1 liner installer to get `ctrld` on your device, or used
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
- `ctrld start` - this will start the service in "local config mode" which enforces the config on disk
- `ctrld start --config=/path/to/ctrld.toml` - 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.
### Self Managed DNS Steering
If you wish to route DNS queries yourself, without any magic on the part of `ctrld` you can start it in pure service mode, where `ctrld` will register as a system service and start the necessary listeners, but make no changes to your DNS configuration (resolv.conf files, or interface with dnsmasq). You can then reference the listeners yourself part of your advanced setup.
- `ctrld service start` - starts ctrld service but makes no DNS routing changes
- `ctrld service start --cd=RESOLVER_ID` - starts ctrld service in cd mode but makes no DNS routing changes
- `ctrld service start --config=/path/to/ctrld.toml` - starts ctrld service in local config mode but makes no DNS routing changes
## Simplest
The simplest possible configuration looks like this. The following config does the following: