Troubleshooting
[](/)
Getting Started
Troubleshooting
On this page
Can't find an answer?
Ask our community for help
First, make sure your device is authorized on the network and you're using the ZeroTier assigned Managed IP address. Aside from that, some OSes block pings in their local firewall by default.
ZeroTier versions 1.10.3 and greater automatically enable ping on ZeroTier adapters.
The firewall is not enabled by default on macOS, and thus pings will not be blocked by default. If your firewall is enabled on macOS, go into System Preferences -> Security & Privacy. Under Firewall Options, ensure "Enable stealth mode" is disabled. Stealth mode blocks pings.
There are far too many Linux distributions out there to list instructions for all of them here. Please refer to your distribution's documentation for how to unblock ICMP packets.
Get Started
Click here to create your network and start adding devices.
This error means that the ZeroTier background service on your computer is either not running, or your local firewall is preventing the UI or CLI from talking to it.
Open Task Manager and go to the "Services" tab. Scroll down until you see "ZeroTierOneService". The status column should say "Running". If it does not, right click on the line and click "Start"
Open Terminal.app and execute the following commands
If your Linux distribution uses systemd, execute:
If not, execute:
Your system firewall is likely blocking communication with the ZeroTier service. Look up instructions for how to unblock an application from the firewall for your OS. ZeroTier will need to be accessible via TCP port 9993 for the UI and CLI to interact with it.
"It was working, but now it's not and I'm not sure why. And I need to get up and running quick."
First, check with your friendly firewall admin that no configuration in the physical network connection has changed.
See the CLI article for help with the CLI.
We're not aware of any bugs that require these steps, or we'd fix them, but sometimes people try the below.
Listed in order of severity:
macOS
Windows
Linux
Open Terminal.app, paste the below, and press enter:
It will ask you for your password. It's the password you use to log in to your mac.
Type "Services" into the Start Menu to open the Windows Services Manager
Start and Stop the zerotier-one service in the Windows Services Manager.
Use the UI, or
zerotier-cli leave <network-id> and zerotier-cli join <network-id>
Find peers.d in the zerotier system directory
The new node ID will have be re-authorized on any networks, and the node's managed IP address manually re-assigned if needed.
Stop the service
Move or delete identity.secret and identity.public files in the zerotier system directory
Delete peers.d too
Start the service
Getting Started
Troubleshooting
On this page
Can't find an answer?
Ask our community for help
Ping is not working[](#ping "Direct link to Ping is not working")
First, make sure your device is authorized on the network and you're using the ZeroTier assigned Managed IP address. Aside from that, some OSes block pings in their local firewall by default.
Windows Firewall[](#windows-firewall "Direct link to Windows Firewall")
ZeroTier versions 1.10.3 and greater automatically enable ping on ZeroTier adapters.
macOS Firewall[](#macos-firewall "Direct link to macOS Firewall")
The firewall is not enabled by default on macOS, and thus pings will not be blocked by default. If your firewall is enabled on macOS, go into System Preferences -> Security & Privacy. Under Firewall Options, ensure "Enable stealth mode" is disabled. Stealth mode blocks pings.
Linux Firewalls[](#linux-firewalls "Direct link to Linux Firewalls")
There are far too many Linux distributions out there to list instructions for all of them here. Please refer to your distribution's documentation for how to unblock ICMP packets.
Get Started
Click here to create your network and start adding devices.
Error: Cannot connect to ZeroTier service (or Node ID "Unknown" in the GUI apps)[](#noservice "Direct link to Error: Cannot connect to ZeroTier service (or Node ID \"Unknown\" in the GUI apps)")
This error means that the ZeroTier background service on your computer is either not running, or your local firewall is preventing the UI or CLI from talking to it.
Windows Service[](#windows-service "Direct link to Windows Service")
Open Task Manager and go to the "Services" tab. Scroll down until you see "ZeroTierOneService". The status column should say "Running". If it does not, right click on the line and click "Start"
macOS Service[](#macos-service "Direct link to macOS Service")
Open Terminal.app and execute the following commands
sudo launchctl unload /Library/LaunchDaemons/com.zerotier.one.plistsudo launchctl load /Library/LaunchDaemons/com.zerotier.one.plistLinux Service[](#linux-service "Direct link to Linux Service")
If your Linux distribution uses systemd, execute:
sudo service zerotier-one startIf not, execute:
/etc/init.d/zerotier-one startStill doesn't work?[](#still-doesnt-work "Direct link to Still doesn't work?")
Your system firewall is likely blocking communication with the ZeroTier service. Look up instructions for how to unblock an application from the firewall for your OS. ZeroTier will need to be accessible via TCP port 9993 for the UI and CLI to interact with it.
Emergency Instructions[](#emergency-instructions "Direct link to Emergency Instructions")
"It was working, but now it's not and I'm not sure why. And I need to get up and running quick."
First, check with your friendly firewall admin that no configuration in the physical network connection has changed.
See the CLI article for help with the CLI.
We're not aware of any bugs that require these steps, or we'd fix them, but sometimes people try the below.
Listed in order of severity:
Restart the service[](#restart-the-service "Direct link to Restart the service")
macOS
Windows
Linux
Open Terminal.app, paste the below, and press enter:
sudo launchctl unload /Library/LaunchDaemons/com.zerotier.one.plistsudo launchctl load /Library/LaunchDaemons/com.zerotier.one.plistIt will ask you for your password. It's the password you use to log in to your mac.
systemctl restart zerotier-oneType "Services" into the Start Menu to open the Windows Services Manager
Start and Stop the zerotier-one service in the Windows Services Manager.
Leave all networks and rejoin them[](#leave-all-networks-and-rejoin-them "Direct link to Leave all networks and rejoin them")
Use the UI, or
zerotier-cli leave <network-id> and zerotier-cli join <network-id>
Stop service, Delete peers.d, Start service[](#stop-service-delete-peersd-start-service "Direct link to Stop service, Delete peers.d, Start service")
Find peers.d in the zerotier system directory
Reset Node ID[](#reset-node-id "Direct link to Reset Node ID")
The new node ID will have be re-authorized on any networks, and the node's managed IP address manually re-assigned if needed.
Stop the service
Move or delete identity.secret and identity.public files in the zerotier system directory
Delete peers.d too
Start the service
Updated on: 12/07/2024
Thank you!