> ## Documentation Index
> Fetch the complete documentation index at: https://dpos.xdr.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# 2. Ubuntu 24.04 Server Installation

> Install the Ubuntu 24.04 Mirror Server with enough disk space, SSH access, and a usable root filesystem.

# 2. Ubuntu 24.04 Server Installation

Use this page when you are building a new Mirror Server. If Ubuntu 24.04 is already installed and validated, continue to **Mirror Server Setup**.

## What you are building

Use a clean **Ubuntu 24.04 LTS amd64** server. The current validated minimum/baseline is:

| Resource           | Requirement                                   |
| ------------------ | --------------------------------------------- |
| CPU                | 2 vCPU minimum; 4 vCPU recommended            |
| Memory             | 4 GB minimum; 8 GB recommended                |
| Disk               | **100 GB total** for the current artifact set |
| Network            | Stable IPv4 reachable by every target DP      |
| DP → Mirror Server | TCP 80                                        |
| Administration     | SSH access recommended                        |

The screenshots below use a 100 GB VM with 6 vCPU and 6 GB RAM. Those values are an example, not a replacement for the current requirements above.

## Step 1 — Create the VM and attach Ubuntu 24.04 ISO

Create the VM, attach an Ubuntu 24.04 Server ISO, and make sure the disk is at least 100 GB.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/1.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=815444c8daf9f7f372d83f3600a1bda1" alt="Example Mirror Server VM hardware configuration" width="1467" height="389" data-path="images/google-sites/02-ubuntu-24-04-installation/1.png" />

## Step 2 — Start the Ubuntu Server installer

Boot the VM and select **Try or Install Ubuntu Server**.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/2.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=efccc84042377e5214d439372d64e41b" alt="Ubuntu Server boot menu" width="1861" height="1105" data-path="images/google-sites/02-ubuntu-24-04-installation/2.png" />

Complete the normal language, keyboard, and network screens for the customer environment.

## Step 3 — Use the full disk and LVM

On **Guided storage configuration**, select the installation disk and LVM.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/3.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=7d655ae4944c255cafffeefd7815d631" alt="Ubuntu guided storage configuration" width="1854" height="1189" data-path="images/google-sites/02-ubuntu-24-04-installation/3.png" />

Ubuntu may initially create a root logical volume that uses only part of the available volume group. Do not leave approximately half of a 100 GB disk unused.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/4.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=1d21f034f278e78a518a288108220865" alt="Initial root logical volume using only part of the disk" width="1784" height="1152" data-path="images/google-sites/02-ubuntu-24-04-installation/4.png" />

Select the root logical volume, choose **Edit**, and increase it to use almost all available space.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/5.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=cd153e7d6947135744d9220a23e93dc4" alt="Expand Ubuntu root logical volume" width="1717" height="1106" data-path="images/google-sites/02-ubuntu-24-04-installation/5.png" />

Confirm that the root filesystem now uses the available disk capacity.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/6.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=e9df851f8b5266480991edf3552d3349" alt="Expanded Ubuntu root filesystem" width="1727" height="1126" data-path="images/google-sites/02-ubuntu-24-04-installation/6.png" />

Then select **Done** and confirm the destructive disk action.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/7.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=27450cc7c1ae8354a5440b01433df4d9" alt="Confirm Ubuntu installation disk formatting" width="1806" height="1164" data-path="images/google-sites/02-ubuntu-24-04-installation/7.png" />

## Step 4 — Create the administrator account

Create the local administrator account. The screenshots use `aella` as an example.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/8.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=3dd957c3b6d0bef1f4552fb2608a1667" alt="Ubuntu server profile configuration" width="1821" height="1168" data-path="images/google-sites/02-ubuntu-24-04-installation/8.png" />

Use the hostname, password, and account policy approved for the deployment. Do not copy example passwords from documentation.

## Step 5 — Install OpenSSH Server

Select **Install OpenSSH server** so the server can be managed remotely after installation.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/9.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=a9a1bcddb97aeff269501c73d8e76b14" alt="Ubuntu OpenSSH server installation selection" width="1863" height="1195" data-path="images/google-sites/02-ubuntu-24-04-installation/9.png" />

## Step 6 — Reboot after installation

When installation completes, select **Reboot Now** and remove/detach the installation ISO if the hypervisor requires it.

<img src="https://mintcdn.com/dp-os-upgrade/CEV0R1FGApiyvrMO/images/google-sites/02-ubuntu-24-04-installation/10.png?fit=max&auto=format&n=CEV0R1FGApiyvrMO&q=85&s=adeb0142aca1c6cf0d129512af096b8d" alt="Ubuntu installation complete" width="1763" height="1130" data-path="images/google-sites/02-ubuntu-24-04-installation/10.png" />

## Step 7 — Verify the installed server

After reboot, log in and run:

```bash theme={null}
cat /etc/os-release
df -h /
ip -br addr
sudo systemctl status ssh --no-pager
```

Confirm:

* Ubuntu reports **24.04**
* the root filesystem has the expected capacity and enough free space
* the intended IPv4 address is active
* SSH is active
* the IP address is stable and reachable from the target DP network

## Step 8 — Configure SSH client keepalive

Long preparation and upgrade operations can leave an SSH terminal idle for extended periods. Configure keepalive on the **SSH client used to connect to the Mirror Server and DP hosts** so an intermediate firewall, NAT device, or idle-session policy is less likely to drop the session.

For OpenSSH, add a host-specific entry to the operator workstation's `~/.ssh/config`:

```sshconfig theme={null}
Host <mirror-or-dp-host>
    ServerAliveInterval 60
    ServerAliveCountMax 5
```

Or use the equivalent options for a one-time connection:

```bash theme={null}
ssh -o ServerAliveInterval=60 -o ServerAliveCountMax=5 <user>@<host>
```

<Tip>
  SSH keepalive helps with idle-session timeouts. It does **not** prevent the expected disconnect when a DP reboots during an Ubuntu release hop. After an expected reboot, reconnect and continue from the next instruction printed by the current upgrade procedure.
</Tip>

## Network note

During preparation, the Mirror Server needs outbound HTTPS access to the current GitHub, Cloudflare R2, ACPS, and Ubuntu bootstrap destinations. During the DP upgrade, target DP hosts retrieve prepared material from the Mirror Server over **HTTP/TCP 80**.

## Next step

Continue with **[3. Mirror Server Setup](/runbook/mirror-server-setup)**.
