🐳 A Docker image for creating a ZeroTier moon in a single step.
This repository provides a Docker image to easily set up a ZeroTier moon, which acts as a control plane for your ZeroTier network. With this image, you can quickly deploy a ZeroTier moon with minimal configuration.
Ensure you have Docker installed on your machine.
- Open the
Dockerfileand locate the lineARG TAG=main. - Replace
mainwith the desired ZeroTier release tag, such as1.14.1or1.14.0. - Build the Docker image using the following command:
docker build -t your-image-name .
To run the ZeroTier moon, execute the following command:
docker run --rm \
--name zerotier-moon \
-p 9993:9993/udp \
-v ./zerotier-one:/var/lib/zerotier-one \
--device /dev/net/tun \
--cap-add NET_ADMIN \
--cap-add SYS_ADMIN \
criogaid/zerotier-moon \
-4 YourIPv4Address \
-6 YourIPv6AddressIfYouHaveOne \
-p 9993YourIPv4Address: Replace with your actual IPv4 address. If you do not have one, you can omit this parameter.YourIPv6AddressIfYouHaveOne: Replace with your actual IPv6 address if available. If not, you can omit this parameter.
For a more streamlined setup, you can use Docker Compose. Below is a sample configuration:
version: '3'
services:
zerotier-moon:
image: criogaid/zerotier-moon
restart: unless-stopped
container_name: zerotier-moon
ports:
- "9993:9993/udp"
volumes:
- ./zerotier-one:/var/lib/zerotier-one
environment:
- ZEROTIER_JOIN_NETWORKS= # Optional, specify the network ID(s) to join
- ZEROTIER_API_SECRET= # Optional, for ZeroTier Central API access
- ZEROTIER_IDENTITY_PUBLIC= # Optional, for custom identity
- ZEROTIER_IDENTITY_SECRET= # Optional, for custom identity
devices:
- /dev/net/tun
cap_add:
- NET_ADMIN
- SYS_ADMIN
command:
- -4 YourIPv4Address # Optional, if you don't have an IPv4 address, remove this line
- -6 YourIPv6AddressIfYouHaveOne # Optional, if you don't have an IPv6 address, remove this line
- -p 9993 # Optional, specify the port to useUpon successful startup, you should see logs similar to the following:
IPv4 address: xxx.xxx.xxx.xxx
IPv6 address is unset, automatically catching the IPv6 address
Failed to catch the IPv6 address.
=> Configuring networks to join
Your ZeroTier moon ID is xxxxxxxxxx. You can orbit the moon using "zerotier-cli orbit xxxxxxxxx xxxxxxxxx"
Starting Control Plane...
Starting V6 Control Plane...To join specific ZeroTier networks, you can set the ZEROTIER_JOIN_NETWORKS environment variable in your Docker Compose configuration. For example:
environment:
- ZEROTIER_JOIN_NETWORKS=888888888888888 666666666666666 999999999999999In this example, the ZeroTier moon will join the networks with IDs 888888888888888, 666666666666666, and 999999999999999. You can specify multiple network IDs separated by spaces.
This Docker image simplifies the process of setting up a ZeroTier moon, allowing you to focus on building your network. For any issues or contributions, feel free to open an issue or pull request in this repository. Happy networking!