You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Joseph Henry caf2b24e45 Updated README.md 9 years ago
artwork README updates, misc filename changes, debug trace fixes, introduction of libzt moniker 9 years ago
docs significant upgrade to selftest, added echotest, better checks for data in queue before socket closure 9 years ago
examples More *.md tweaks 9 years ago
ext BSD-license-compatible, and NO_STACK build variants 9 years ago
include Updated README.md 9 years ago
src Fix broken PICO compile (mismerge of LwIP reintroduction.) 9 years ago
test Added layer2 SOCK_RAW example code and stubs 9 years ago
zto@04cee3b8d3 Added ZeroTierOne as a submodule 9 years ago
.gitignore Added to .gitignore 9 years ago
.gitmodules Added ZeroTierOne as a submodule 9 years ago
BUILDING.md Slight reorganization of docs 9 years ago
Makefile fixed connect/accept behaviour, added to selftest, renamed BSD makefile 9 years ago
README.md Updated README.md 9 years ago
RELEASE-NOTES.md significant upgrade to selftest, added echotest, better checks for data in queue before socket closure 9 years ago
TESTING.md Minor changes to selftest, updated TESTING readme, removed old test personality conf files 9 years ago
check.sh dynamic loading of network stack no longer needed 9 years ago
make-bsd.mk Added ZeroTierOne as a submodule 9 years ago
make-liblwip.mk BSD-license-compatible, and NO_STACK build variants 9 years ago
make-linux.mk Added default network stack (picoTCP) and default protocol versions to makefile 9 years ago
make-mac.mk Added default network stack (picoTCP) and default protocol versions to makefile 9 years ago
objects.mk dynamic loading of network stack no longer needed 9 years ago

README.md

libzt

Embed ZeroTier directly into your app


ZeroTier makes it easy to securely connect devices, servers, cloud VMs, containers, and apps everywhere and manage them at scale. Now, with libzt 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

All targets will output to build/. Complete instructions here


Testing and Debugging

Licensing

  • For a BSD license, build using the lwIP network stack with STACK_LWIP=1
  • For a GPL license, build using the picoTCP network stack with STACK_PICO=1

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