A Smart Ethernet Switch for Earth
Go to file
2014-08-20 12:36:11 -07:00
attic docs 2014-08-15 12:59:49 -04:00
ext Make install scripts also symlink zerotier-idtool script, and doc updates. 2014-08-07 06:25:01 -07:00
netconf-service Fix for network not found in netconf. 2014-06-27 00:47:07 +00:00
node Add MAC to listnetworks, and some other make stuff. 2014-08-19 14:11:02 -07:00
osnet (1) Tweak LAN locator beacon frequencies, (2) Windows virtual networks 2014-08-12 17:20:34 -07:00
root-topology (1) distribute default root-topology in new dictionary format, (2) bump peer serialization version to force obsolescence of old supernodes, (3) stop outputting a log message every time we poll for software updates 2014-08-14 19:52:22 -04:00
windows Some UI fixes for Windows. 2014-08-20 10:22:30 -07:00
ZeroTierUI Some UI fixes for Windows. 2014-08-20 10:22:30 -07:00
.gitignore Rename topology/ to be more descriptive, and some more updates. 2014-08-07 20:21:07 -04:00
AUTHORS.txt docs 2013-10-03 15:48:26 -04:00
BUILDING.txt VERSION 0.7.0: updated docs (no version change) 2014-02-16 12:08:13 -08:00
buildinstaller.sh Systemd support on Linux - GitHub issue #39 2014-02-14 15:18:59 -08:00
LICENSE.txt New git repository for release - version 0.2.0 tagged 2013-07-04 16:56:19 -04:00
main.cpp Fix for GitHub issue #102 2014-08-20 12:36:11 -07:00
make-linux.mk Add MAC to listnetworks, and some other make stuff. 2014-08-19 14:11:02 -07:00
make-mac.mk UI stuff and sign .dmg on build. 2014-08-19 17:42:17 -07:00
Makefile Create common Makefile that automatically loads make rules on a per-OS basis. 2013-12-03 14:11:43 -08:00
objects.mk Add signatures to Dictionary, and fix unhex() API in Utils to be a little safer. 2014-08-05 09:56:49 -07:00
README.md Update GitHub README 2014-04-16 11:40:48 -07:00
RUNNING.txt VERSION 0.7.0: updated docs (no version change) 2014-02-16 12:08:13 -08:00
selftest-crypto-vectors.hpp Blech... moving on! 2013-10-20 15:54:32 -04:00
selftest.cpp Refactor HttpClient a bit. 2014-08-16 09:08:52 -07:00
version.h VERSION 0.9.1: bug fixes and experimental bridging support 2014-07-03 13:32:53 -07:00

ZeroTier One - Ethernet Virtualization

ZeroTier One is an ethernet virtualization engine. It creates virtual LANs of almost unlimited size that span physical network boundaries.

The underlying protocol is peer to peer with managed anchor points ("supernodes") for instant-on communication, assisted NAT traversal, and relaying for users who cannot make P2P connections. All unicast packets are encrypted end-to-end using private keys that only you control. Multicast and broadcast work as they would on a normal LAN, except that traffic is throttled and intelligently prioritized on large networks to stay within bandwidth limits while preserving essential functionality (multicast triage algorithm). Its behavior is not unlike some enterprise-grade intelligent ethernet switches designed for huge wired networks such as university LANs.

Visit ZeroTier Networks on the web for more information. Follow the ZeroTier blog and the GitHub project to stay up to date. See the GitHub-hosted wiki (sidebar) for technical info and help for various platforms.

Auto-updating binary packages that install easily can be found here. Packages for popular Linux distributions that neatly wrap the Linux installer/uninstaller are coming soon. If you want to build from source, clone this repository and see BUILDING.txt and RUNNING.txt. If you build manually you'll have to update manually.

Once you are up and running, you can create an account on the network control panel if you want to create a private network or you can join Earth by running (on Linux and Mac) sudo ./zerotier-cli join 8056c2e21c000001. (Earth is a public virtual network, meaning that it has no access control and allows anyone to join. Make sure your system is up to date and you have no unprotected network services listening.)

Note: If UDP traffic over port 9993 (at a minimum) is not permitted by your local or network firewall(s), ZeroTier One will fall back to TCP tunneling to supernodes over port 443 and will not be able to make direct NAT-t connections to other peers. This fallback mode slows things down considerably. If you're getting very poor performance check your firewall settings. You can see if fallback mode is active by checking for outbound TCP connections from the zerotier-one process to port 443 on five or six hosts in the zerotier.com domain. (See Defaults.cpp for a list of these hosts.)

Most users will use IPv4 and/or IPv6 over ZeroTier One, but since it virtualizes at the ethernet (layer 2) level it can technically host almost any protocol. Users have made classic multiplayer games work over IPX, for example. Services like DHCP and IPv6 NDP for link-local addresses can work automatically.

The service is free for public networks and for managed private networks up to ten users. The code is open source and is licensed under the GNU GPL v3 (not LGPL). If you'd like to embed it in a closed-source commercial product, please e-mail contact@zerotier.com to discuss licensing.