Skip to main content

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.

Custom events viewer form showing all logs selected

Custom events viewer form showing dnclient entered within the Source field

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.

Services app showing the status of the dnclient serviceServices app showing the status of the dnclient 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.

Nebula site details page in the mobile app, shows a 'Logs' option third from the topNebula site details page in the mobile app, shows a 'Logs' option third from the top