Viewing dnclient Logs

This guide explains how to view logs for dnclient in each of the supported platforms.

Linux

Logs

If you are using systemd:

journalctl --unit=dnclient --follow

Config info

note

This command will strip the private info such as pki.key from the config, allowing you to safely share the output with Defined Networking support while troubleshooting.

sudo ./dnclient info

Service status

systemctl status dnclient

# outputs
● dnclient.service - Defined Networking client daemon
     Loaded: loaded (/etc/systemd/system/dnclient.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2022-11-30 16:07:48 CST; 2min 3s ago
   Main PID: 546 (dnclient)
      Tasks: 10 (limit: 4560)
     Memory: 19.2M
     CGroup: /system.slice/dnclient.service
             └─546 /home/alice/dnclient run -server https://api.defined.net

# ... shows dnclient logs ...

macOS

Logs

sudo tail -f /usr/local/var/log/dnclient.*

Config info

note

This command will strip the private info such as pki.key from the config, allowing you to safely share the output with Defined Networking support while troubleshooting.

sudo ./dnclient info

Service status

sudo launchctl list dnclient

{
    "StandardOutPath" = "/usr/local/var/log/dnclient.out.log";
    "LimitLoadToSessionType" = "System";
    "StandardErrorPath" = "/usr/local/var/log/dnclient.err.log";
    "Label" = "dnclient";
    "OnDemand" = false;
    "LastExitStatus" = 0;
    "PID" = 663;
    "Program" = "/Users/alice/.local/bin/dnclient";
    "ProgramArguments" = (
        "/Users/alice/.local/bin/dnclient";
        "run";
        "-server";
        "https://api.defined.net";
    );
};

Windows

Logs

Open the Event Viewer app, click on Custom Views -> Administrative Events -> manually enter dnclient for "Event sources".

You can also make a "Custom View" which filters on the dnclient source.

Config info

note

This command will strip the private info such as pki.key from the config, allowing you to safely share the output with Defined Networking support while troubleshooting.

& 'C:\Program Files\Defined Networking\DNClient\dnclient.exe' info

Service status

To check the status of the service, open Services app, and find the Defined Networking Client service in the list. You should be able to see the status and start or stop the service.

Android / iOS

Logs

Tap on the site in question and tap "View Logs" on the details page for that site. You can then read, share, or delete your logs.

info

Logs are cleared each time a site is started.