summaryrefslogtreecommitdiff
path: root/RUNNING.txt
blob: 4bfa47f86978b9a4db612059347ad0813c8a502a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
First build it -- see BUILDING.txt -- then...

-- MacOS --

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
stores in the above directory. To install this, type:

sudo make -f Makefile.mac install-mac-tap

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.
If run with no options, it will use the default home directory above.

sudo ./zerotier-one &

Finally, join the Earth network (the big public LAN and the only net for now):

sudo zerotier-cli join 8056c2e21c000001

Try pinging earth.zerotier.net and going to http://earth.zerotier.net/ in a
browser to see if you're online.

-- Linux

On Linux, the default ZeroTier home is:

/var/lib/zerotier-one

Just type:

sudo mkdir /var/lib/zerotier-one
sudo ./zerotier-one &

When run with no options, ZT1 uses its default home path on the current
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.

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.

-- Windows

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.

-- 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