dec0dOS / zero-ui

ZeroUI - ZeroTier Controller Web UI - is a web user interface for a self-hosted ZeroTier network controller.
Explore the screenshots »

Bug Report · Feature Request · Ask a Question

About

Built With

Frontend:

• React
• Material UI

Backend:

• NodeJS
• Express
• Lowdb

Ready to use deployment solution:

• Docker
• Docker Compose
• Caddy

Getting Started

Prerequisites

The recommended method to install ZeroUI is by using Docker and Docker Compose. To install Docker and Docker Compose on your system, please follow the installation guide from the official Docker documentation.

For HTTPS setup you will need a domain name. You can get it for free at https://www.duckdns.org.

Installation

The most simple one-minute installation. Great for the fresh VPS setup.

1. Create a project directory

mkdir -p /srv/zero-ui/
cd /srv/zero-ui/

2. Download the docker-compose.yml file

wget https://raw.githubusercontent.com/dec0dOS/zero-ui/main/docker-compose.yml

or

curl -L -O https://raw.githubusercontent.com/dec0dOS/zero-ui/main/docker-compose.yml

3. Replace YOURDOMAIN.com with your domain name and set admin credentials (ZU_DEFAULT_PASSWORD) in docker-compose.yml
4. Pull the image

docker pull dec0dos/zero-ui

5. Run the containers

docker-compose up -d --no-build

6. Check if everything is okay (CTRL-C to stop log preview)

docker-compose logs -f

7. Disable your firewall for the following ports: 80/tcp, 443/tcp and 9993/udp

• on Ubuntu/Debian with ufw installed:

 ufw allow 80/tcp
 ufw allow 443/tcp
 ufw allow 9993/udp

• or you may use the old good iptables:

 iptables -A INPUT -p tcp --dport 80 -j ACCEPT
 iptables -A INPUT -p tcp --dport 443 -j ACCEPT
 iptables -A INPUT -p udp --dport 9993 -j ACCEPT

8. Navigate to https://YOURDOMAIN.com/app/. Now you could use your ZeroUI instance with HTTPS support and automated certificate renewal.

To disable Caddy proxy and HTTPS, remove the https-proxy from docker-compose.yml, set ZU_SECURE_HEADERS to false and change zero-ui port expose to ports.

Advanced manual setups are also supported. Check the following environment variables as a reference:

ZeroUI could be deployed as a regular nodejs web application, but it requires a ZeroTier controller that is installed with the zerotier-one package. For more info about the network controller, you could read here.

For Ansible Role, please refer to zero-ui-ansible repo.

echo "{\"settings\": {\"portMappingEnabled\": true,\"softwareUpdate\": \"disable\",\"allowManagementFrom\": [\"0.0.0.0/0\"]}}" > /var/lib/zerotier-one/local.conf

Usage

After installation, log in with your credentials that are declared with ZU_DEFAULT_USERNAME and ZU_DEFAULT_PASSWORD.

Currently, almost all main ZeroTier Central features are available. Refer to the roadmap for more information.

For the screenshots, please refer to the screenshots.

Update

To get the latest version just run

docker-compose pull && docker-compose up -d --no-build

in the folder where docker-compose.yml is located. Backup is not required as your data is saved in Docker volumes but recommended. You could also set up watchtower for automatic updates.

docker run -d \
 --name watchtower \
 -v /var/run/docker.sock:/var/run/docker.sock \
 --restart always \
 containrrr/watchtower \
 --cleanup --include-restarting \
 zu-main zu-controller

Backup

You should regularly back up the zerotier-one and data folders in your ZeroUI installation directory. You should do it manually before the upgrade via the following commands:

tar cvf backup-ui.tar data/
tar cvf backup-zt.tar zerotier-one/

Roadmap

See the open issues for a list of proposed features (and known issues).

• Top Feature Requests (Add your votes using the 👍 reaction)
• Top Bugs (Add your votes using the 👍 reaction)
• Newest Bugs

Please try to create bug reports that are:

• Reproducible. Include steps to reproduce the problem.
• Specific. Include as much detail as possible: which version, what environment, etc.
• Unique. Do not duplicate existing opened issues.
• Scoped to a Single Bug. One bug per report.

Contributing

First off, thanks for taking the time to contribute! Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

1. Fork the project
2. Create your feature branch (git checkout -b feat/amazing_feature)
3. Commit your changes (git commit -m 'feat: add amazing_feature')
4. Push to the branch (git push origin feat/amazing_feature)
5. Open a Pull Request

ZeroUI uses conventional commits, so please follow the guidelines. Run yarn commit to open TUI that follows conventional commits guidelines.

Development environment

To set up a development environment, please follow these steps:

1. Clone the repo

git clone https://github.com/dec0dOS/zero-ui.git
cd zero-ui

2. Install packages

yarn install

3. Start the development server

yarn dev

4. Navigate to http://localhost:3000

It is also required to install the ZeroTier controller. On Linux installing the zerotier-one package is enough, other platforms require some tweaking. Firstly you should get the controller token. On macOS, you could find it with the following command:

sudo cat "/Library/Application Support/ZeroTier/One/authtoken.secret"

After you could start the ZeroUI development environment:

ZU_CONTROLLER_TOKEN=TOKEN_FROM_authtoken.secret yarn dev

For other platforms, please refer to ZeroTier manual.

Support

Reach out to me at one of the following places:

• GitHub Discussions

Security

ZeroUI follows good practices of security, but 100% security cannot be assured. ZeroUI is provided "as is" without any warranty. Use at your own risk.

For enterprise support, a more reliable and scalable solution, please use ZeroTier Central.

For more information and to report security issues, please refer to our security documentation.

Copyright notice

ZeroUI is not affiliated or associated with or endorsed by ZeroTier Central or ZeroTier, Inc.

License

See LICENSE for more information.