Client Logs

How you access client logs depends on the platform. Use the section for your client type below.

WindowsCopy Anchor Link

You can view logs in the Pangolin client GUI under Preferences > Logs.

You can also open the log file directly. The default location is:

C:\ProgramData\pangolin\logs\pangolin.log

To tail the log in PowerShell:

Get-Content "C:\ProgramData\pangolin\logs\pangolin.log" -Tail 0 -Wait

MacCopy Anchor Link

Mac uses the Apple system logger. To stream Pangolin logs:

log stream --predicate 'subsystem == "net.pangolin.Pangolin" OR subsystem == "net.pangolin.Pangolin.PacketTunnel"' --level debug --style compact

CLI / LinuxCopy Anchor Link

The default log file location is:

~/.config/pangolin/logs/client.log

If you run pangolin up in detached mode, you can tail logs with:

pangolin logs client -f -n 10

This example follows new log lines and shows the last 10 rows.

Alternatively, run in attached mode to see logs in the current terminal session:

sudo pangolin up --attach

AndroidCopy Anchor Link

Turn on Enable Log Collection under Preferences. Tunnel logs are then saved to a file you can download from the app. You can also view logs under Preferences > Logs. See Android.

iOSCopy Anchor Link

Because of how iOS handles system logging, attach the iPhone to a Mac and use Console.app to view logs.

In Console.app, add a Subsystem filter for:

net.pangolin.Pangolin