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

# Install Mirror Manager

> Install the current runtime on Ubuntu 24.04 and understand what the installer changes.

# Install Mirror Manager

## Install

```bash theme={null}
sudo apt-get update
sudo apt-get install -y git

git clone https://github.com/xdr-labs/ubuntu-mirror-automation.git
cd ubuntu-mirror-automation
sudo ./install.sh
```

For non-interactive or CI bootstrap:

```bash theme={null}
sudo ./install.sh --non-interactive
```

## What the installer does

The installer currently:

1. validates Ubuntu 24.04 LTS amd64, root, systemd, and apt
2. installs required packages such as nginx, whiptail/dialog, curl, and Python
3. creates the mirror directories without formatting disks
4. installs the runtime under `/usr/local/lib/ubuntu-mirror`
5. installs `ubuntu-offline-mirror` under `/usr/local/bin`
6. installs the nginx base configuration
7. opens the GUI when an interactive TTY is available

The installer does **not** start the large R2 or ACPS downloads. Those begin only from **Menu 2 — Download and Prepare Upgrade Files**.

## Open the GUI later

```bash theme={null}
sudo ubuntu-offline-mirror mirror-manager
```

After an SSH disconnect, reopen the GUI with this command. Do not rerun `install.sh` just to reopen an existing installation.

## Updating the application

When you deliberately update the source repository:

```bash theme={null}
git pull
sudo ./install.sh
```

A reinstall after a source update can rebuild or republish client artifacts and make previous readiness state stale. Re-run the required Mirror Manager steps when the application instructs you to do so.