Skip to main content

How to Collect Diagnostic Logs

When submitting a support request, diagnostic logs help us identify and resolve issues more quickly.

Generate a dump file

Generate a debug dump file with device and network information for troubleshooting using the ZeroTier CLI. This file can be useful when talking with ZeroTier technical support staff.

CLI
zerotier-cli dump

The output file is always named zerotier_dump.txt and is written to a fixed location depending on your operating system:

PlatformOutput Location
WindowsUser's Desktop
macOSUser's Desktop
LinuxCurrent working directory
caution

The dump command creates a file with information about your device and networks. Some of this information (Physical IP addresses, public identities, etc) may be sensitive.

Permissions

On Unix-like systems you may need to use sudo zerotier-cli, while on Windows you will need to use an administrator command prompt. If you see missing authentication token and authtoken.secret not found (or readable) you're likely trying to run zerotier-cli from an account with insufficient privileges.