libzt
Embed ZeroTier directly into your app
A library version of ZeroTier, 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. We provide a POSIX-like socket API supporting SOCK_STREAM, SOCK_DGRAM, and SOCK_RAW to make the integration simple. There's no need for system-wide virtual interfaces. This connection is exclusive to your app and fully encrypted via the Salsa20 cipher. For a more in-depth discussion on the technical side of ZeroTier, check out our Manual
C++ Example
#include <sys/socket.h>
#include <arpa/inet.h>
#include <netinet/in.h>
#include "libzt.h"
int main()
{
char *str = "welcome to the machine";
char *ip = "10.8.8.42"; // remote address
int port = 8080; // remote port
struct sockaddr_in addr;
addr.sin_family = AF_INET;
addr.sin_addr.s_addr = inet_addr(ip);
addr.sin_port = htons(port);
zts_startjoin("path", 0xc7cd7c981b0f52a2); // config path, nwid
int fd, err = 0;
if ((fd = zts_socket(AF_INET, SOCK_STREAM, 0)) < 0) {
printf("error creating socket\n");
}
if ((err = zts_connect(fd, (const struct sockaddr *)&addr, sizeof(addr))) < 0) {
printf("error connecting to remote host\n");
}
if ((err = zts_write(fd, str, strlen(str))) < 0) {
printf("error writing to socket\n");
}
if ((err = zts_close(fd)) < 0) {
printf("error closing socket\n");
}
zts_stop();
return 0;
}
For an example using only the Virtual Layer 2, see examples/layer2
Build
We recommend using CMake for its extensive cross-platform build support.
git submodule init
git submodule update
./ext/patch_submodules.sh
cmake -H. -Bbuild -DCMAKE_BUILD_TYPE=DEBUG
cmake --build build
Builds are placed in bin\lib. Use libzt.a or libzt.dylib in your application. Change CMAKE_BUILD_TYPE to RELEASE for a smaller and optimized build.
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.
Commercial License
If you want a commercial license to use libzt in your product contact us directly via contact@zerotier.com.