Self-hosting quickstart guide (5 min)
Netzilo is a self-hosted platform that you can deploy on your own servers. It consists of components developed by Netzilo, as well as third-party open-source services:
Netzilo Components
- Management Service
- Management UI Dashboard
- Signal Service
Third-Party Open-Source Components
- STUN/TURN service – Coturn
- Identity provider - Zitadel
For more details on the architecture, refer to the Architecture section.
If you're new to Netzilo, we recommend trying it before self-hosting. Our managed cloud version is available, and you can get started with just a few clicks Check it out!
Infrastructure Requirements:
- A Linux VM with at least 4 vCPU, 8GB of memory, and 50GB HDD.
- The VM does not need to be publicly accessible
- The VM should be deployed in a network where it has connectivity to the target resources (VMs/Applications).
- The VM must be able to access the public network via:
- TCP/TLS (Port 443) – at least to the Netzilo server’s hosted domain
- UDP (Any Port) (Optional – see Note 1)
Software Requirements:
- All OS libraries updated and upgraded sudo apt-get update && sudo apt-get upgrade -y
Software Requirements:
- Generate a setup key as described at https://doc.netzilo.com/how-to/register-machines-using-setup-keys and save it for use while starting the Routing Peer.
- Deploy the Routing Peer by executing the following command: curl -fsSL https://pkgs.netzilo.com/download/linux/install_netzilo_linux.sh | sh
- Start the Routing Peer by running the following command: netzilo up --management-url https://domain-name --admin-url https://domain-name--setup-key set-up key
- Verify the Routing Peer status by executing the following command. Ensure that the Management, Signal, and Relay servers are connected: netzilo status -d
Netzilo connects peers either via P2P or through a relay server. P2P connections significantly improve performance, reduce latency, and increase data transfer speeds. To enable P2P connections, the Routing Peer VM must allow all outbound UDP traffic to the public network.
Netzilo connects peers either via P2P or through a relay server. P2P connections significantly improve performance, reduce the latency, and increase the data transfer speeds. To enable P2P connections, the VM must allow inbound UDP traffic on port 3478 and outbound traffic on all UDP ports.
Requirements Checklist
## Outbound Firewall settings
Preferred
| Source | Destination | Port | Protocol | Check |
|---|---|---|---|---|
| IP of VM | ANY | 443 | TCP/TLS (gRPC, Stun, Turn, https) |
IP of VM | go.netzilo.com | ANY | UDP | | srv.netzilo.com | | | | stun.netzilo.com | | | | turn.netzilo.com | | |
Minimum
| Source | Destination | Port | Protocol | Check |
|---|---|---|---|---|
| IP of VM | go.netzilo.com | ANY | TCP/TLS (gRPC, Stun, Turn, https) | |
| srv.netzilo.com | ||||
| stun.netzilo.com | ||||
| turn.netzilo.com |
Quick self-hosting with Zitadel IdP
In this guide, we will guide you through deploying Netzilo with Zitadel) as the identity provider for user management using a single-line setup script and docker containers.
This is the quickest way to try self-hosted Netzilo. It should take around 5 minutes to get started if you already have a public domain and a VM.
Contact Information For additional details or support during the POC setup, please contact our technical team at support@netzilo.com.
Feel free to ping us on Slack if you have any questions
- Netzilo managed version: https://app.netzilo.com
- Follow us on Linkedin
- Join our Slack Channel