netbird/docs/self-hosting.md

Self-hosting

Wiretrustee is an open-source platform that can be self-hosted on your servers.

It relies on components developed by Wiretrustee Authors Management Service, Management UI Dashboard, Signal Service, a 3rd party open-source STUN/TURN service Coturn and a 3rd party service Auth0.

All the components can be self-hosted except for the Auth0 service. We chose Auth0 to "outsource" the user management part of the platform because we believe that implementing a proper user auth requires significant amount of time to make it right. We focused on connectivity instead.

If you would like to learn more about the architecture please refer to the Wiretrustee Architecture section.

Requirements

• Virtual machine offered by any cloud provider (e.g., AWS, DigitalOcean, Hetzner, Google Cloud, Azure ...).
• Any Linux OS.
• Docker Compose installed (see Install Docker Compose).
• Domain name pointing to the public IP address of your server.
• Open ports 443, 33071, 33073, 3478 (Dashboard, Management HTTP API, Management gRpc API, Coturn STUN/TURN respectively) on your server.
• Maybe a cup of coffee or tea :)

Step-by-step guide

For this tutorial we will be using domain test.wiretrustee.com which points to our Ubuntu 20.04 machine hosted at Hetzner.

1. Create Auth0 account at auth0.com.

2. Login to your server, clone Wiretrustee repository:

   git clone https://github.com/wiretrustee/wiretrustee.git wiretrustee/
   

   and switch to the wiretrustee/infrastructure_files/ folder that contains docker compose file:

   cd wiretrustee/infrastructure_files/
   

3. Prepare configuration files.

   To simplify the setup we have prepared a script to substitute required properties in the docker-compose.yml.tmpl and management.json.tmpl files.

   The setup.env file contains the following properties that have to be filled:

   # e.g. app.mydomain.com
   WIRETRUSTEE_DOMAIN=""
   # e.g. dev-24vkclam.us.auth0.com
   WIRETRUSTEE_AUTH0_DOMAIN=""
   # e.g. 61u3JMXRO0oOevc7gCkZLCwePQvT4lL0
   WIRETRUSTEE_AUTH0_CLIENT_ID=""
   # e.g. https://app.mydomain.com/
   WIRETRUSTEE_AUTH0_AUDIENCE=""
   # e.g. hello@mydomain.com
   WIRETRUSTEE_LETSENCRYPT_EMAIL=""
   

   Please follow the steps to get the values.

4. Configure WIRETRUSTEE_AUTH0_DOMAIN WIRETRUSTEE_AUTH0_CLIENT_ID WIRETRUSTEE_AUTH0_AUDIENCE properties.

   • To obtain these, please use Auth0 React SDK Guide up until "Install the Auth0 React SDK".

     ❕ Use https://YOUR DOMAIN as Allowed Callback URLs, Allowed Logout URLs, Allowed Web Origins and Allowed Origins (CORS)

   • set the variables in the setup.env

5. Configure WIRETRUSTEE_AUTH0_AUDIENCE property.

   • Check Auth0 Golang API Guide to obtain AuthAudience.
   • set the property in the setup.env file.

6. Configure WIRETRUSTEE_LETSENCRYPT_EMAIL property.

   This can be any email address. Let's Encrypt will create an account while creating a new domain.

7. Make sure all the properties set in the setup.env file and run:

   ./configure.sh
   

   This will export all the properties as environment variables and generate docker-compose.yml and management.json files substituting required variables.

8. Run docker compose:

   docker-compose up -d
   

9. Optionally check the logs by running:

   docker-compose logs signal
   docker-compose logs management
   docker-compose logs coturn
   docker-compose logs dashboard