some file

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!

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.

Infrastructure Requirements:

  • A Linux VM with at least 4 vCPU, 8GB of memory, and 50GB HDD.
  • The VM should be publicly accessible on
    • HTTPS/TLS/gRPC: 443
    • HTTP: 80 (Optional – see Note1)
    • TCP: 3478
    • UDP 3478 (Optional – see Note2)
  • Public domain name pointing to the VM.
  • SSL certificate for the public domain (Optional – see Note1)
  • The VM should be able to access public network via
    • HTTPS: 443
    • UDP: ANY (Optional – see Note2)

Software Requirements:

  • All OS libraries updated and upgraded sudo apt-get update && sudo apt-get upgrade -y
  • Latest docker and docker-compose installed
  • Installed library jq sudo apt-get install jq

To use your own SSL certificate, place the certificate (as cert.crt) and private key (as priv.key) on the VM, then enter the path when prompted by the installation script.

For automatic certificate acquisition, ensure that the VM is publicly accessible on port 80 (HTTP). When the installation script asks for a certificate folder, simply press Enter. Netzilo will then acquire and manage SSL certificates from Let's Encrypt automatically.

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.

Deployment

Contact Information For additional details or support during the POC setup, please contact our technical team at [email protected].

Feel free to ping us on Slack if you have any questions