Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mokeyish/zerotier-edge

A lightweight(less than 5 MB) ZeroTier Controller Web UI for a self-hosted ZeroTier network controller that deployed at your edge.
https://github.com/mokeyish/zerotier-edge

self-hosted webui zero-ui zerotier zerotier-controller ztncui

Last synced: about 6 hours ago
JSON representation

A lightweight(less than 5 MB) ZeroTier Controller Web UI for a self-hosted ZeroTier network controller that deployed at your edge.

Awesome Lists containing this project

README

        

# Zerotier-Edge

A ZeroTier Controller Web UI for a self-hosted ZeroTier network controller that deployed at your edge.

Explore the screenshots »

## Features

- Convenient, launched with a single command.
- Lightweight, less than 5 MB.
- No docker, just a single binary.
- No database, storing all configurations in zerotier working directory(`*.ext.json`).

## Quick start

1. Install Zerotier-Edge.

Download `Zerotier-Edge` from [here](https://github.com/mokeyish/zerotier-edge/releases) then unzip it.

2. Launch service

```shell
./zerotier-edge
```

Note: `./zerotier-edge --help` will show the help of command.

3. Access Web UI to manage your controller.

1. Open [http://127.0.0.1:9394/](http://127.0.0.1:9394/) on your browser.
2. Login with token ([How to get your token?](https://docs.zerotier.com/self-hosting/network-controllers/#authtoken))
3. Manage your controller.

4. Configure remote access (optional)

It is recommended to enable https in Nginx and then proxy our service.

```nginx
location /zerotier-edge/ {
proxy_pass http://127.0.0.1:9394/;
}
```

## Building

To build `Zerotier-Edge` from source, ensure that you have [Rust](https://www.rust-lang.org/learn/get-started) installed. Then, follow these steps in your terminal:

1. Clone the repository:

```shell
git clone https://github.com/mokeyish/zerotier-edge.git
cd zerotier-edge
```

2. Install dependencies:

```shell
just setup
```

3. Build:

```shell
just build --release
```

4. Display available options:

```shell
./target/release/zerotier-edge --help
```

5. Launch the application:

```shell
./target/release/zerotier-edge
```

## Similar projects

- [ZeroUI](https://github.com/dec0dOS/zero-ui)
- [ztncui](https://github.com/key-networks/ztncui)

Note:I don't want to use heavyweight deployment based on Docker/Nodejs. So I created this project.

## License

This project is licensed under GPL-3.0 license (LICENSE-GPL-3.0 or [https://opensource.org/licenses/GPL-3.0](https://opensource.org/licenses/GPL-3.0))

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the GPL-3.0 license, shall be licensed as above, without any additional terms or conditions.