Updated Troubleshooting Guide (markdown)

Yegor S
2025-02-14 16:24:10 -05:00
parent 92bffdb2f4
commit 1ab2eab90e

@@ -3,6 +3,11 @@ Under normal circumstances and if there are no conflicts with other software, yo
Below assumes you're using a Linux-like operating system.
## Fails to start
If you get an error like "an error occurred while performing test query: xxxx" this usually means the listener that was started is not receiving any DNS queries so the installation is aborted since the service will probably not work. This can make it difficult to perform the rest of the troubleshooting, as the application won't be running. Append the `--skip_self_checks` flag to the start command, which will prevent `ctrld` from testing itself, and start anyway. Then you can perform the rest of the checks.
The most common cause for this issue is 3rd party software hijacking DNS traffic, or misconfiguration of the device itself.
## Check if ctrld is running
First, let's check to see if `ctrld` is still running.