<aside> 👉 Before proceeding, we recommend you first review our Architecture Overview.

</aside>

Our installation process requires ansible to be installed either locally on your computer, or remotely on a linux machine. Please ensure this has been setup prior to continuing with this installation process.

Linux Distribution

We currently only support Debian 11 Bullseye.

SECTIONS

Domain Names

Various services require a proper dns configuration. Please ensure the following domains are configured and ready prior to installation.

CONTROLLER

This is the main URL for the control panel.

Example: portal, dashboard, controller.

METRICS

The metrics server will collect container and node metrics, as well as serve as the log aggregation platform for containers. The controller and all nodes in the availability zone (or region depending on configuration) will need to connect to this via SSL. Ensure you have a valid DNS configured; the ansible installer will automatically generate a lets encrypt ssl certificate.

Recommended Format: metrics.<availability-zone>.<region>.example.net

Example: metrics.a.ams.example.net

DEFAULT APPLICATION URL

Each container service will receive a default URL. You will need to define a unique base domain for each availability-zone. For example, for availability-zone a in region ams:

Example: a.ams.example.net

POWERDNS

If you choose to use the default power dns installation that is part of our ansible installer, you will need to configure two records for each. You may omit this step if you’re using our AutoDNS integration.