This repository provides a script to install and upgrade ZeroTier One from the upstream latest release on Alpine Linux.
This repository focuses only on:
- Building and installing the ZeroTier One binary on Alpine Linux
- Checking upstream latest releases and performing update flow
- OpenRC service registration and default runlevel enablement
- Avoiding redundant builds using recorded installed version state
zerotier-one-alpine-linux.sh
Single script for release detection, build, installation, service management, and installed version tracking.
- OS: Alpine Linux (uses
apk, OpenRC) - Architecture:
apk-based Alpine build environment (for example, amd64) - Required privileges: root
- Package installation: required build and runtime packages are installed with
apkwhen the script runs. - Source retrieval: latest tag is resolved from the GitHub API, then tarball is downloaded.
- Build: default build excludes Rust SSO path (
ZT_SSO_SUPPORTED=0) for standard Alpine builds. - Install: installation is performed via
make install. - Service: creates a managed
/etc/init.d/zerotier-onethat keeps the foreground daemon under OpenRC supervision, migrates the earlier double-background service template, adds it to the default runlevel, then starts/restarts the service. - Version record: stored at
/var/lib/zerotier-one/.zerotierone-installed-version.
chmod +x zerotier-one-alpine-linux.sh
./zerotier-one-alpine-linux.shOptions:
--force: force rebuild/reinstall even if the installed version matches latest--no-service: skip service stop/register/start steps--with-rust: install Rust toolchain and use Rust-capable build path
./zerotier-one-alpine-linux.sh --help- After install/upgrade:
rc-service zerotier-one statuscommand -v zerotier-onezerotier-one -h
The script is designed for forward update to the latest release and does not provide automatic rollback to a previous version.
Recommended rollback method (manual):
- Stop service:
rc-service zerotier-one stop - Restore a previously backed-up binary/configuration manually
- Remove from default runlevel:
rc-update del zerotier-one default - Clean generated service script if needed:
/etc/init.d/zerotier-one - Remove version state file if required:
/var/lib/zerotier-one/.zerotierone-installed-version
- Source and release metadata are fetched over HTTPS from GitHub endpoints.
- This workflow assumes trusted OS package indexes; in restricted networks, add mirror policy and optional hash/signature verification before deployment.
- No additional personal data collection is performed during build execution.
This project is licensed under the MIT License (LICENSE).
- Upstream project: ZeroTier One (https://github.com/zerotier/ZeroTierOne)
- Author: itinfra7 (GitHub: itinfra7)