Installing Ubuntu

Koios requires Ubuntu Server as its host operating system. This page covers the key settings to configure during installation.

Download

Download the Ubuntu Server ISO from the official Ubuntu website. Koios supports:

When running through the Ubuntu Server installer, keep these recommendations in mind:

Minimal installation — select the minimal server install. Koios does not require a desktop environment or additional packages.
OpenSSH — enable the OpenSSH server during installation so you can manage the machine remotely.
Static IP address — assign a static IP address (either during installation or afterward via Netplan) so the Koios web interface is always reachable at a known address.
Disk partitioning — use the default guided partitioning, or allocate at least 20 GB for the root partition. Docker volumes store their data under /var/lib/docker/.

No Desktop Required

Koios is managed entirely through its web interface. You do not need to install Ubuntu Desktop or any graphical environment.

Once Ubuntu is installed, update the system packages:

sudo apt update && sudo apt upgrade -y

Then proceed to install Docker Engine.