Because the Mac client for Netmaker (netclient) can’t be installed in /etc and doesn’t have some of the tools on other platforms, I needed to figure out how to diagnose and fix some issues that presented themselves. If you have anything to add please let me know.
And to the Gravitl boys- steal away if you think it’s useful…

*Warning- some of these commands assume the install is in /usr/local/bin because that’s where my installer puts it, this could be very wrong for you…
Show interface and config
open Terminal and issue this command-
sudo wg show
Example- Should return something like
interface: utun4
  public key: <key>
  private key: (hidden)
  listening port: 49387
peer: <peer>
  endpoint: 112.213.38.200:51821
  allowed ips: 172.21.255.254/32
  latest handshake: 59 seconds ago
  transfer: 185.91 KiB received, 224.09 KiB sent
  persistent keepalive: every 20 seconds
interface: utun5
  public key: <pubkey>
  private key: (hidden)
  listening port: 55919
Is the Launch daemon active?
open Terminal and issue this command-
launchctl list |grep netclient
Example- Should return something like (not sure if this is normal- need to check)
– 78 launchd.gravitl-netclient
393 0 com.gravitl.netclient
Check the logs
open Terminal and issue this command-
sudo tail -f /etc/netclient/com.gravitl.netclient.log
Example- Should return something like
[netclient] 2022-03-24 17:13:53 received peer update for node random-words randomnumber
[netclient] 2022-03-24 17:13:55 received peer update for node clientname networkname
[netclient] 2022-03-24 17:24:07 received peer update for node random-words randomnumber
[netclient] 2022-03-24 17:24:08 received peer update for node clientname networkname
[netclient] 2022-03-24 17:34:16 received peer update for node clientname networkname
[netclient] 2022-03-24 17:34:17 received peer update for node random-words randomnumber
Are the binaries installed?
open Terminal and issue this command-
ls /usr/local/bin/
Example- Should return something like
clamav-config clamconf clamdtop freshclam sigtool wireguard-go
clambc clamdscan clamscan netclient wg
Can the system use the binaries?
We can use the ‘which’ command to see if the operating system knows where the required apps are…
open Terminal and issue this command-
which netclient
Example- Should return something like
/usr/local/bin/netclient
You can do the same for other dependancies –
which wg
Example- Should return something like
/usr/local/bin/wg
which wireguard-go
Example- Should return something like
/usr/local/bin/wireguard-go