ZeroTier One as Docker Image
Go to file
2022-06-12 21:50:15 +02:00
.github/workflows fix manifest creation 2022-06-12 21:50:15 +02:00
k8s add net_raw cap for bridge mode, seems to be not a default for podman on fedora 2022-01-31 11:58:07 +01:00
patches disable sso 2022-05-24 14:13:25 +02:00
scripts add entrypoint and define env variables to override local settings 2022-06-12 17:53:02 +02:00
docker-compose.yml Add docker-compose file for convenience 2021-08-13 03:59:21 -07:00
Dockerfile copy missing scripts 2022-06-12 19:30:07 +02:00
Dockerfile.bridge cleanup 2022-06-12 20:33:21 +02:00
LICENSE move repo from znx to here 2019-10-17 16:11:51 +02:00
README.md add net_raw cap for bridge mode, seems to be not a default for podman on fedora 2022-01-31 11:58:07 +01:00

Docker Pulls Quay.io Enabled Multiarch build

zerotier-docker

Description

This is a container based on a lightweight Alpine Linux image and a copy of ZeroTier One. It's designed to allow you to run ZeroTier One as a service on container-oriented distributions like Fedora CoreOS, though it should work on any Linux system with Docker or Podman.

Run

To run this container in the correct way requires some special options to give it special permissions and allow it to persist its files. Here's an example (tested on Fedora CoreOS):

docker run --name zerotier-one --device=/dev/net/tun --net=host \
  --cap-add=NET_ADMIN --cap-add=SYS_ADMIN \
  -v /var/lib/zerotier-one:/var/lib/zerotier-one zyclonite/zerotier

This runs zyclonite/zerotier in a container with special network admin permissions and with access to the host's network stack (no network isolation) and /dev/net/tun to create tun/tap devices. This will allow it to create zt# interfaces on the host the way a copy of ZeroTier One running on the host would normally be able to.

In other words that basically does the same thing that running zerotier-one directly on the host would do, except it runs in a container. Since Fedora CoreOS has no package management this is the preferred way of distributing software for it.

It also mounts /var/lib/zerotier-one to /var/lib/zerotier-one inside the container, allowing your service container to persist its state across restarts of the container itself. If you don't do this it'll generate a new identity every time. You can put the actual data somewhere other than /var/lib/zerotier-one if you want.

To join a zerotier network you can use

docker exec zerotier-one zerotier-cli join 8056c2e21c000001

or create an empty file with the network as name

/var/lib/zerotier-one/networks.d/8056c2e21c000001.conf

Bridge mode

It is the implementation of the local network bridge paper

docker run --name zerotier-one --device=/dev/net/tun \
  --cap-add=NET_ADMIN --cap-add=NET_RAW --cap-add=SYS_ADMIN \
  -v /var/lib/zerotier-one:/var/lib/zerotier-one zyclonite/zerotier:bridge

That will start the zero-one, establish connection and build the bridge once the zt interface is up.

Source

https://github.com/zyclonite/zerotier-docker