CLI
[](/)
Getting Started
CLI
On this page
Mac and Windows platforms have graphical interfaces that provide tray or task bar icons. All platforms have the zerotier-cli command line interface which can be used to join and leave networks and check the status of the zerotier-one service.
sudo
On Unix-like systems you may need to preface zerotier-cli commands with sudo, while on Windows you will need to use an administrator-mode command prompt.
Get your ZeroTier address and check the service status
Join, leave, and list networks. Remember, ZeroTier networks are 16-digit IDs that look like 8056c2e21c000001
info
If you see missing authentication token and authtoken.secret not found (or readable) you're likely trying to run zerotier-cli from a non-administrative account. On macOS, Linux, or other Unix based systems, use sudo zerotier-cli. On Windows, use an Administrator Command Prompt.
More advanced commands can be found using zerotier-cli -h
caution
This command creates a file on your desktop with information about your device and networks. Some of this info may be considered private information, so post this in public at your own discretion.
Getting Started
CLI
On this page
Mac and Windows platforms have graphical interfaces that provide tray or task bar icons. All platforms have the zerotier-cli command line interface which can be used to join and leave networks and check the status of the zerotier-one service.
sudo
On Unix-like systems you may need to preface zerotier-cli commands with sudo, while on Windows you will need to use an administrator-mode command prompt.
Basic CLI usage[](#basic-cli-usage "Direct link to Basic CLI usage")
Get your ZeroTier address and check the service status
zerotier-cli status200 info 998765f00d 1.2.13 ONLINEJoin, leave, and list networks. Remember, ZeroTier networks are 16-digit IDs that look like 8056c2e21c000001
zerotier-cli join ################200 join OKzerotier-cli leave ################200 leave OKzerotier-cli listnetworks200 listnetworks 8056c2e21c000001 earth.zerotier.net 02:99:35:84:f9:dc OK PUBLIC 29.152.27.109/7info
If you see missing authentication token and authtoken.secret not found (or readable) you're likely trying to run zerotier-cli from a non-administrative account. On macOS, Linux, or other Unix based systems, use sudo zerotier-cli. On Windows, use an Administrator Command Prompt.
Network Join Status Codes[](#network-join-status-codes "Direct link to Network Join Status Codes")
Advanced CLI usage[](#advanced-cli-usage "Direct link to Advanced CLI usage")
More advanced commands can be found using zerotier-cli -h
Collect debug info for support[](#zerotier-cli-dump "Direct link to Collect debug info for support")
zerotier-cli dumpcaution
This command creates a file on your desktop with information about your device and networks. Some of this info may be considered private information, so post this in public at your own discretion.
Updated on: 12/07/2024
Thank you!