# Install on Debian or Ubuntu

Install the standard edition of doona v0.1.0-rc.2 with your system package manager. For doona lite, use the [archive instructions](https://doona.daeuniverse.org/en/install-manual.md).

Use a terminal on the gateway and a new download directory. Run the steps in the same shell; in a root shell, omit `sudo`. Check the [honk prerequisites](https://doona.daeuniverse.org/en/install.md#install) before installing the backend.

## 1. Prepare the download tools

```sh tab="sudo"
sudo apt update
sudo apt install curl ca-certificates
```

```sh tab="root"
apt update
apt install curl ca-certificates
```

## 2. Download and verify the package

Download from the [v0.1.0-rc.2 release](https://github.com/Zakkaus/doona/releases/tag/v0.1.0-rc.2):

```sh
BASE=https://github.com/Zakkaus/doona/releases/download/v0.1.0-rc.2
FILE=doona-web_0.1.0-rc.2-1_all.deb
curl -fL -O "$BASE/$FILE" -O "$BASE/SHA256SUMS"
awk -v file="$FILE" '$2 == file' SHA256SUMS | sha256sum -c -
```

Continue only when every selected file reports `OK`. If verification fails or finds no checksum line, check the filenames and download again before installing.

For download or binary errors, see [Installation errors](https://doona.daeuniverse.org/en/install.md#installation-errors).

## 3. Install the web files

```sh
sudo apt install "./$FILE"
ls -l /usr/share/doona-web/index.html
```

The last command must list `/usr/share/doona-web/index.html`. Use `/usr/share/doona-web` as the UI directory when following [Minimal configuration](https://doona.daeuniverse.org/en/minimal-configuration.md); the [`ui` setting](https://doona.daeuniverse.org/en/configuration.md#config) selects it.

The Debian package is named `doona-web`. Do not substitute `apt install doona`: that name belongs to a different package in Debian and Ubuntu.

### Recover a UI replaced by Debian’s doona package

If `apt upgrade` replaced an older `doona` web package with the unrelated network fuzzer and the UI disappeared:

1. Install the verified `doona-web` package using the steps above, and `doona-web-fonts` below if needed. These packages replace or conflict with the old web packages below version 1.0.
2. Change the existing [`ui` setting](https://doona.daeuniverse.org/en/configuration.md#config) to `/usr/share/doona-web`, then [restart honk](https://doona.daeuniverse.org/en/service-management.md) and reload the browser page.
3. If the unrelated `doona` remains installed, run `sudo apt remove doona`. This leaves `doona-web` installed.

### Optional packages

See [optional assets](https://doona.daeuniverse.org/en/install.md#doona) to decide whether you need fonts or precompressed files. To install one, use its filename from the table as `FILE` in the commands below. The example selects fonts.

| Asset | Filename |
| --- | --- |
| Fonts | `doona-web-fonts_0.1.0-rc.2-1_all.deb` |
| Precompressed files | `doona-web-precompressed_0.1.0-rc.2-1_all.deb` |

```sh
FILE=doona-web-fonts_0.1.0-rc.2-1_all.deb
curl -fL -O "$BASE/$FILE"
awk -v file="$FILE" '$2 == file' SHA256SUMS | sha256sum -c - &&
  sudo apt install "./$FILE"
```

## 4. Install the backend

Install the backend using [Install honk](https://doona.daeuniverse.org/en/install.md#install), then return here. If a compatible honk is already installed, keep it.

Continue with [Quick start](https://doona.daeuniverse.org/en/quick-start.md) to configure honk and sign in.