Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rwv/docker-zerotier-moon
🐳 A docker image to create ZeroTier moon in one step.
https://github.com/rwv/docker-zerotier-moon
docker docker-image network zerotier zerotier-moon zerotier-one
Last synced: 19 days ago
JSON representation
🐳 A docker image to create ZeroTier moon in one step.
- Host: GitHub
- URL: https://github.com/rwv/docker-zerotier-moon
- Owner: rwv
- License: gpl-3.0
- Created: 2018-04-28T10:28:04.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-06T17:46:56.000Z (almost 2 years ago)
- Last Synced: 2024-11-09T20:39:11.245Z (about 1 month ago)
- Topics: docker, docker-image, network, zerotier, zerotier-moon, zerotier-one
- Language: Shell
- Homepage:
- Size: 68.4 KB
- Stars: 442
- Watchers: 11
- Forks: 141
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - rwv/docker-zerotier-moon - 🐳 A docker image to create ZeroTier moon in one step. (Shell)
README
# docker-zerotier-moon
A docker image to create ZeroTier moon in one setp.
Have a look at dockerized ZeroTier: [rwv/zerotier](https://github.com/rwv/docker-zerotier).
## Table of Contents
- [Quickstart](#quickstart)
- [Start a container](#start-a-container)
- [Show ZeroTier moon id](#show-zerotier-moon-id)
- [Docker Compose](#docker-compose)
- [Compose file](#compose-file)
- [Show ZeroTier moon id](#show-zerotier-moon-id-1)
- [Advanced usage](#advanced-usage)
- [Manage ZeroTier](#manage-zerotier)
- [Mount ZeroTier conf folder](#mount-zerotier-conf-folder)
- [IPv6 support](#ipv6-support)
- [Custom port](#custom-port)
- [Network privilege](#network-privilege)
- [Multi-arch support](#multi-arch-support)
- [GitHub Container Registry](#github-container-registry)
## Quickstart
### Start a container
```
docker run --name zerotier-moon -d --restart always -p 9993:9993/udp -v ~/somewhere:/var/lib/zerotier-one seedgou/zerotier-moon -4 1.2.3.4
```
Replace `1.2.3.4` with your moon's IPv4 address and replace `~/somewhere` with where you would like to store your configuration.
### Show ZeroTier moon id
```
docker logs zerotier-moon
```
## Docker Compose
### Compose file
`docker-compose.yml` example:
``` YAML
version: "3"
services:
zerotier-moon:
image: seedgou/zerotier-moon
container_name: "zerotier-moon"
restart: always
ports:
- "9993:9993/udp"
volumes:
- ./config:/var/lib/zerotier-one
entrypoint:
- /startup.sh
- "-4"
- 1.2.3.4
```
Replace `1.2.3.4` with your moon's IPv4 address.
### Show ZeroTier moon id
``` bash
docker-compose logs
```
## Advanced usage
### Manage ZeroTier
```
docker exec zerotier-moon zerotier-cli
```
### Mount ZeroTier conf folder
```
docker run --name zerotier-moon -d -p 9993:9993/udp -v ~/somewhere:/var/lib/zerotier-one seedgou/zerotier-moon -4 1.2.3.4
```
When creating a new container without mounting ZeroTier conf folder, a new moon id will be generated. This command will mount `~/somewhere` to `/var/lib/zerotier-one` inside the container, allowing your ZeroTier moon to presist the same moon id. If you don't do this, when you start a new container, a new moon id will be generated.
### IPv6 support
```
docker run --name zerotier-moon -d -p 9993:9993/udp seedgou/zerotier-moon -4 1.2.3.4 -6 2001:abcd:abcd::1
```
Replace `1.2.3.4`, `2001:abcd:abcd::1` with your moon's IP. You can remove `-4` option in pure IPv6 environment.
### Custom port
```
docker run --name zerotier-moon -d -p 9994:9993/udp seedgou/zerotier-moon -4 1.2.3.4 -p 9994
```
Replace 9994 with your own custom port for ZeroTier moon.
### Network privilege
If you encounter issue: `ERROR: unable to configure virtual network port: could not open TUN/TAP device: No such file or directory`, please add `--cap-add=NET_ADMIN --cap-add=SYS_ADMIN --device=/dev/net/tun` args. Similar to this:
```
docker run --cap-add=NET_ADMIN --cap-add=SYS_ADMIN --device=/dev/net/tun --name zerotier-moon -d --restart always -p 9993:9993/udp seedgou/zerotier-moon -4 1.2.3.4
```
Solution provided by [Jonnyan404's Fork](https://github.com/Jonnyan404/docker-zerotier-moon).
See Also [Issue #1](https://github.com/rwv/docker-zerotier-moon/issues/1).
### Multi-arch support
This image supports `linux/386`, `linux/amd64`, `linux/ppc64le`, `linux/arm64`, `linux/arm/v7`, `linux/arm/v6`, `linux/s390x` and `linux/riscv64`.
### GitHub Container Registry
This image is also published on GitHub Container Registry: [`ghcr.io/rwv/zerotier-moon`](https://ghcr.io/rwv/zerotier-moon)