Embed ZeroTier directly into your app
C C++ TeX Makefile Python Shell
Latest commit 04188f0 Aug 16, 2017 @joseph-henry joseph-henry committed on GitHub Merge pull request #18 from laduke/nodejs
Create node example
Permalink
Failed to load latest commit information.
artwork README updates, misc filename changes, debug trace fixes, introductio… Jun 14, 2017
docs significant upgrade to selftest, added echotest, better checks for da… Jun 16, 2017
examples Create node example directory Aug 16, 2017
ext Managed Routes now supported, with automatic add/remove Aug 14, 2017
include Build tweaks, better flag handling across makefiles Aug 14, 2017
obj .gitignore for obj/ Aug 14, 2017
src Build tweaks, better flag handling across makefiles Aug 14, 2017
test Managed Routes now supported, with automatic add/remove Aug 14, 2017
zto @ ee1dc16 Incremented ZTO submodule for getRoutes() Aug 10, 2017
.gitignore Managed Routes now supported, with automatic add/remove Aug 14, 2017
.gitmodules Added ZeroTierOne as a submodule Jun 26, 2017
BUILDING.md Slight reorganization of docs Jun 15, 2017
Jenkinsfile Parallelized Jenkinsfile Aug 15, 2017
Makefile fixed connect/accept behaviour, added to selftest, renamed BSD makefile Jun 12, 2017
README.md Added contribution section and updated licensing section Aug 2, 2017
RELEASE-NOTES.md significant upgrade to selftest, added echotest, better checks for da… Jun 16, 2017
TESTING.md Minor changes to selftest, updated TESTING readme, removed old test p… Jul 13, 2017
check.sh dynamic loading of network stack no longer needed Apr 7, 2017
make-bsd.mk Added ZeroTierOne as a submodule Jun 26, 2017
make-liblwip.mk Build tweaks for Jenkins Aug 14, 2017
make-linux.mk Removed makefile error ignore flags Aug 15, 2017
make-mac.mk Makefile fix for macOS Aug 15, 2017
objects.mk Implemented barebones VL2 SOCK_RAW functionality, moved ZT core helpe… Aug 2, 2017

README.md

libzt

Embed ZeroTier directly into your app


A library version of the popular ZeroTier One, libzt makes it easy to securely connect devices, servers, cloud VMs, containers, and apps everywhere and manage them at scale. Now you can bake this ability directly into your app or service using your preferred language or framework. We provide a BSD socket-like API supporting SOCK_STREAM, SOCK_DGRAM, and SOCK_RAW to make the integration simple. There's also no longer any need for system-wide virtual interfaces. This connection is exclusive to your app and fully encrypted via the Salsa20 cipher.


irc

Pre-Built Binaries Here: zerotier.com/download.shtml.


Example

#include "libzt.h"

char *str = "welcome to the machine"; // test msg 
char *nwid = "c7cd7c9e1b0f52a2";      // network to join
char *path = "zt1";                   // path where this node's keys and configs will be stored
char *ip = "10.8.8.42";               // host on ZeroTier network
int port = 8080;                      // resource's port

struct sockaddr_in addr;
addr.sin_family = AF_INET;
addr.sin_addr.s_addr = inet_addr(ip);
addr.sin_port = hton(port);	

zts_simple_start(path, nwid);
int fd = zts_socket(AF_INET, SOCK_STREAM, 0);
zts_connect(fd, (const struct sockaddr *)addr, sizeof(addr));
zts_write(fd, str, strlen(str));
zts_close(fd);

Bindings for various languages

For an example using only the Virtual Layer 2, see test/layer2.cpp


Building (linux, macos, bsd, win, ios)

git submodule init
git submodule update
make static_lib
make tests

All targets will output to build/. Complete instructions here


Testing and Debugging

Contributing

Please make pull requests against the dev branch. The master branch is release, and edge is for unstable and work in progress changes and is not likely to work.

License

  • Commercial, with BSD license, build using lwIP network stack with STACK_LWIP=1, then contact us directly via contact@zerotier.com to discuss commercial licensing.
  • Personal, with GPL license, build using picoTCP network stack with STACK_PICO=1, everything is free. Have fun.

Regardless of which network stack you build with, the socket API will remain the same.