2013-10-03 19:48:26 +00:00
|
|
|
First build it -- see BUILDING.txt -- then...
|
2013-07-04 20:56:19 +00:00
|
|
|
|
2013-10-03 19:48:26 +00:00
|
|
|
-- MacOS --
|
2013-07-04 20:56:19 +00:00
|
|
|
|
|
|
|
|
By convention, ZeroTier One will keep its state here on mac:
|
|
|
|
|
|
|
|
|
|
/Library/Application Support/ZeroTier/One
|
|
|
|
|
|
|
|
|
|
ZeroTier ships with a kernel extension for its own tap device, which it
|
2013-10-28 19:18:06 +00:00
|
|
|
stores in the above directory. To install this, type:
|
2013-07-04 20:56:19 +00:00
|
|
|
|
2013-07-06 04:50:14 +00:00
|
|
|
sudo make -f Makefile.mac install-mac-tap
|
2013-07-04 20:56:19 +00:00
|
|
|
|
|
|
|
|
This will create the ZeroTier One home above if it does not exist and install
|
|
|
|
|
the kext there. Note that the kext must be owned by root:wheel. The make
|
|
|
|
|
rule for install-mac-tap takes care of that.
|
|
|
|
|
|
|
|
|
|
Next, simply run the binary. It must be run as root to open the tap device.
|
2013-08-30 19:30:53 +00:00
|
|
|
If run with no options, it will use the default home directory above.
|
2013-07-04 20:56:19 +00:00
|
|
|
|
2013-08-30 19:30:53 +00:00
|
|
|
sudo ./zerotier-one &
|
2013-07-04 20:56:19 +00:00
|
|
|
|
2013-10-03 19:48:26 +00:00
|
|
|
Finally, join the Earth network (the big public LAN and the only net for now):
|
2013-07-04 20:56:19 +00:00
|
|
|
|
2013-10-20 20:14:27 +00:00
|
|
|
sudo zerotier-cli join 8056c2e21c000001
|
2013-07-04 20:56:19 +00:00
|
|
|
|
2013-10-03 19:48:26 +00:00
|
|
|
Try pinging earth.zerotier.net and going to http://earth.zerotier.net/ in a
|
|
|
|
|
browser to see if you're online.
|
2013-07-04 20:56:19 +00:00
|
|
|
|
|
|
|
|
-- Linux
|
|
|
|
|
|
|
|
|
|
On Linux, the default ZeroTier home is:
|
|
|
|
|
|
|
|
|
|
/var/lib/zerotier-one
|
|
|
|
|
|
2013-10-03 19:48:26 +00:00
|
|
|
Just type:
|
2013-07-04 20:56:19 +00:00
|
|
|
|
|
|
|
|
sudo mkdir /var/lib/zerotier-one
|
2013-08-30 19:30:53 +00:00
|
|
|
sudo ./zerotier-one &
|
|
|
|
|
|
|
|
|
|
When run with no options, ZT1 uses its default home path on the current
|
2013-10-03 19:48:26 +00:00
|
|
|
platform. Note that ZT1 requires the Linux tap driver, so it must be
|
|
|
|
|
available in the kernel or as a module. In most Linux distributions it's
|
|
|
|
|
included out of the box and should just work.
|
2013-07-04 20:56:19 +00:00
|
|
|
|
2013-10-03 19:48:26 +00:00
|
|
|
Finally, join the Earth network (the big public LAN and the only net for now):
|
|
|
|
|
|
|
|
|
|
sudo zerotier-cli join bc8f9a8ee3000001
|
|
|
|
|
|
|
|
|
|
Try pinging earth.zerotier.net and going to http://earth.zerotier.net/ in a
|
|
|
|
|
browser to see if you're online.
|
2013-07-04 20:56:19 +00:00
|
|
|
|
|
|
|
|
-- Windows
|
|
|
|
|
|
2013-10-03 19:48:26 +00:00
|
|
|
Port in progress, and it's going to pretty much always be more painful to
|
|
|
|
|
build than *nix systems. Just wait for the binary release unless you're
|
|
|
|
|
brave, in which case you can load the VS2012 solution and play around.
|
2013-11-21 23:28:03 +00:00
|
|
|
|
|
|
|
|
-- Open UDP port 9993
|
|
|
|
|
|
|
|
|
|
As noted in README.md, to actually function properly, you need to open
|
|
|
|
|
UDP port 9993 in your firewall. Following are instructions to open UDP port
|
|
|
|
|
9993 for specific operating systems.
|
|
|
|
|
|
|
|
|
|
--- Ubuntu (version 12.04 and possibly other versions, too)
|
|
|
|
|
|
|
|
|
|
Follow the Ubuntu documentation about UFW https://help.ubuntu.com/community/UFW
|
|
|
|
|
|
|
|
|
|
Check if your UFW is active.
|
|
|
|
|
|
|
|
|
|
sudo ufw status verbose
|
|
|
|
|
|
|
|
|
|
If it is active, open UDP port 9993
|
|
|
|
|
|
|
|
|
|
sudo ufw allow 9993/udp
|
|
|
|
|
|
|
|
|
|
You should now be able to ping and browse earth.zerotier.net
|
|
|
|
|
|
