---
title: "Installing Ubuntu"
description: "Set up the Ubuntu operating system for Koios"
source_url: https://ai-ops.com/docs/installation/installing-ubuntu
---

# 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:

- Ubuntu Server 20.04 LTS
- Ubuntu Server 22.04 LTS
- Ubuntu Server 24.04 LTS (recommended)

## Installation Tips

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/`.

> [!NOTE] No Desktop Required
> Koios is managed entirely through its web interface. You do not need to install Ubuntu Desktop or any graphical environment.

## After Installation

Once Ubuntu is installed, update the system packages:

```bash
sudo apt update && sudo apt upgrade -y
```

Then proceed to install Docker Engine.

## What's Next

- [Installing Docker Engine](https://ai-ops.com/docs/installation/installing-docker.md) — install the Docker runtime
