1. Installation

1.1. Hardware requirements

Akira is packaged for a set of supported operating system platforms (see Supported platforms). Any machine (real or virtual) with one of these platforms can be used to run Akira.

For many installations, servers that have been pensioned off from active duty can perform admirably as Akira servers. For serving a small LAN, even low-performance machines may be sufficient. If the server's operational duties are larger, then a suitably performant machine can be selected.

We aren't able to recommend specifications in this document as it would be outdated quickly. It is best to profile the usage patterns and prepare a hardware configuration accordingly.

Error

TODO: Add a link to Akira support for help with hardware configuration.

Error

TODO: Add a link to a tuning section.

1.2. Supported platforms

Akira is written to run on POSIX operating systems. The following platforms are supported by Akira version 1.99.15.20260531075356.32922aefed:

Red Hat Enterprise Linux 10 (x86_64)
Red Hat Enterprise Linux 10 (aarch64)
Red Hat Enterprise Linux 9 (x86_64)
Red Hat Enterprise Linux 9 (aarch64)
Fedora Linux 44 (x86_64)
Fedora Linux 44 (aarch64)
Fedora Linux 43 (x86_64)
Fedora Linux 43 (aarch64)
Debian 13 "Trixie" (amd64)
Debian 13 "Trixie" (arm64)
Debian 13 "Trixie" (riscv64)
Debian 12 "Bookworm" (amd64)
Debian 12 "Bookworm" (arm64)
Ubuntu 26.04 LTS "Resolute Raccoon" (amd64)
Ubuntu 26.04 LTS "Resolute Raccoon" (arm64)
Ubuntu 26.04 LTS "Resolute Raccoon" (riscv64)
Ubuntu 24.04 LTS "Noble Numbat" (amd64)
Ubuntu 24.04 LTS "Noble Numbat" (arm64)
Ubuntu 24.04 LTS "Noble Numbat" (riscv64)
Ubuntu 22.04 LTS "Jammy Jellyfish" (amd64)
Ubuntu 22.04 LTS "Jammy Jellyfish" (arm64)

Packages for current versions of FreeBSD will be added in the future.

Note

For information about Akira's version numbering, see Version numbering scheme. For information about Akira's branches and EOL dates, see Version branches.

1.3. RPM platforms

Note

Users of Red Hat Enterprise Linux clones such as Rocky Linux and AlmaLinux can use the Red Hat Enterprise Linux packages of the corresponding version and follow the corresponding installation instructions.

1.3.1. Red Hat Enterprise Linux 10 (x86_64)

To install Akira version 1.99.15.20260531075356.32922aefed on Red Hat Enterprise Linux 10 (x86_64), follow these steps as the root user.

First, install the akira-release RPM package that will add the akira-epel and akira-epel-testing DNF repositories to your system, as well as associated GPG keys used to verify signed RPM packages from these repositories:

# dnf install https://download.banu.com/packages/akira/1.99/epel/10/x86_64/akira-release-1.99.15.20260531075356.32922aefed-1.el10.noarch.rpm

Then, install the akira RPM package that will install the Akira software and documentation:

# dnf install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.3.2. Red Hat Enterprise Linux 10 (aarch64)

To install Akira version 1.99.15.20260531075356.32922aefed on Red Hat Enterprise Linux 10 (aarch64), follow these steps as the root user.

First, install the akira-release RPM package that will add the akira-epel and akira-epel-testing DNF repositories to your system, as well as associated GPG keys used to verify signed RPM packages from these repositories:

# dnf install https://download.banu.com/packages/akira/1.99/epel/10/aarch64/akira-release-1.99.15.20260531075356.32922aefed-1.el10.noarch.rpm

Then, install the akira RPM package that will install the Akira software and documentation:

# dnf install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.3.3. Red Hat Enterprise Linux 9 (x86_64)

To install Akira version 1.99.15.20260531075356.32922aefed on Red Hat Enterprise Linux 9 (x86_64), follow these steps as the root user.

First, install the akira-release RPM package that will add the akira-epel and akira-epel-testing DNF repositories to your system, as well as associated GPG keys used to verify signed RPM packages from these repositories:

# dnf install https://download.banu.com/packages/akira/1.99/epel/9/x86_64/akira-release-1.99.15.20260531075356.32922aefed-1.el9.noarch.rpm

Then, install the akira RPM package that will install the Akira software and documentation:

# dnf install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.3.4. Red Hat Enterprise Linux 9 (aarch64)

To install Akira version 1.99.15.20260531075356.32922aefed on Red Hat Enterprise Linux 9 (aarch64), follow these steps as the root user.

First, install the akira-release RPM package that will add the akira-epel and akira-epel-testing DNF repositories to your system, as well as associated GPG keys used to verify signed RPM packages from these repositories:

# dnf install https://download.banu.com/packages/akira/1.99/epel/9/aarch64/akira-release-1.99.15.20260531075356.32922aefed-1.el9.noarch.rpm

Then, install the akira RPM package that will install the Akira software and documentation:

# dnf install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.3.5. Fedora Linux 44 (x86_64)

To install Akira version 1.99.15.20260531075356.32922aefed on Fedora Linux 44 (x86_64), follow these steps as the root user.

First, install the akira-release RPM package that will add the akira-fedora and akira-fedora-testing DNF repositories to your system, as well as associated GPG keys used to verify signed RPM packages from these repositories:

# dnf install https://download.banu.com/packages/akira/1.99/fedora/44/x86_64/akira-release-1.99.15.20260531075356.32922aefed-1.fc44.noarch.rpm

Then, install the akira RPM package that will install the Akira software and documentation:

# dnf install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.3.6. Fedora Linux 44 (aarch64)

To install Akira version 1.99.15.20260531075356.32922aefed on Fedora Linux 44 (aarch64), follow these steps as the root user.

First, install the akira-release RPM package that will add the akira-fedora and akira-fedora-testing DNF repositories to your system, as well as associated GPG keys used to verify signed RPM packages from these repositories:

# dnf install https://download.banu.com/packages/akira/1.99/fedora/44/aarch64/akira-release-1.99.15.20260531075356.32922aefed-1.fc44.noarch.rpm

Then, install the akira RPM package that will install the Akira software and documentation:

# dnf install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.3.7. Fedora Linux 43 (x86_64)

To install Akira version 1.99.15.20260531075356.32922aefed on Fedora Linux 43 (x86_64), follow these steps as the root user.

First, install the akira-release RPM package that will add the akira-fedora and akira-fedora-testing DNF repositories to your system, as well as associated GPG keys used to verify signed RPM packages from these repositories:

# dnf install https://download.banu.com/packages/akira/1.99/fedora/43/x86_64/akira-release-1.99.15.20260531075356.32922aefed-1.fc43.noarch.rpm

Then, install the akira RPM package that will install the Akira software and documentation:

# dnf install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.3.8. Fedora Linux 43 (aarch64)

To install Akira version 1.99.15.20260531075356.32922aefed on Fedora Linux 43 (aarch64), follow these steps as the root user.

First, install the akira-release RPM package that will add the akira-fedora and akira-fedora-testing DNF repositories to your system, as well as associated GPG keys used to verify signed RPM packages from these repositories:

# dnf install https://download.banu.com/packages/akira/1.99/fedora/43/aarch64/akira-release-1.99.15.20260531075356.32922aefed-1.fc43.noarch.rpm

Then, install the akira RPM package that will install the Akira software and documentation:

# dnf install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4. Debian and Ubuntu platforms

1.4.1. Debian 13 "Trixie" (amd64)

To install Akira version 1.99 on Debian 13 "Trixie" (amd64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/trixie/13/amd64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/debian/trixie/amd64/ /" > /etc/apt/sources.list.d/akira-trixie-amd64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.2. Debian 13 "Trixie" (arm64)

To install Akira version 1.99 on Debian 13 "Trixie" (arm64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/trixie/13/arm64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/debian/trixie/arm64/ /" > /etc/apt/sources.list.d/akira-trixie-arm64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.3. Debian 13 "Trixie" (riscv64)

To install Akira version 1.99 on Debian 13 "Trixie" (riscv64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/trixie/13/riscv64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/debian/trixie/riscv64/ /" > /etc/apt/sources.list.d/akira-trixie-riscv64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.4. Debian 12 "Bookworm" (amd64)

To install Akira version 1.99 on Debian 12 "Bookworm" (amd64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/bookworm/12/amd64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/debian/bookworm/amd64/ /" > /etc/apt/sources.list.d/akira-bookworm-amd64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.5. Debian 12 "Bookworm" (arm64)

To install Akira version 1.99 on Debian 12 "Bookworm" (arm64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/bookworm/12/arm64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/debian/bookworm/arm64/ /" > /etc/apt/sources.list.d/akira-bookworm-arm64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.6. Ubuntu 26.04 LTS "Resolute Raccoon" (amd64)

To install Akira version 1.99 on Ubuntu 26.04 LTS "Resolute Raccoon" (amd64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/resolute/26.04 LTS/amd64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/ubuntu/resolute/amd64/ /" > /etc/apt/sources.list.d/akira-resolute-amd64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.7. Ubuntu 26.04 LTS "Resolute Raccoon" (arm64)

To install Akira version 1.99 on Ubuntu 26.04 LTS "Resolute Raccoon" (arm64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/resolute/26.04 LTS/arm64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/ubuntu/resolute/arm64/ /" > /etc/apt/sources.list.d/akira-resolute-arm64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.8. Ubuntu 26.04 LTS "Resolute Raccoon" (riscv64)

To install Akira version 1.99 on Ubuntu 26.04 LTS "Resolute Raccoon" (riscv64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/resolute/26.04 LTS/riscv64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/ubuntu/resolute/riscv64/ /" > /etc/apt/sources.list.d/akira-resolute-riscv64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.9. Ubuntu 24.04 LTS "Noble Numbat" (amd64)

To install Akira version 1.99 on Ubuntu 24.04 LTS "Noble Numbat" (amd64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/noble/24.04 LTS/amd64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/ubuntu/noble/amd64/ /" > /etc/apt/sources.list.d/akira-noble-amd64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.10. Ubuntu 24.04 LTS "Noble Numbat" (arm64)

To install Akira version 1.99 on Ubuntu 24.04 LTS "Noble Numbat" (arm64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/noble/24.04 LTS/arm64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/ubuntu/noble/arm64/ /" > /etc/apt/sources.list.d/akira-noble-arm64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.11. Ubuntu 24.04 LTS "Noble Numbat" (riscv64)

To install Akira version 1.99 on Ubuntu 24.04 LTS "Noble Numbat" (riscv64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/noble/24.04 LTS/riscv64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/ubuntu/noble/riscv64/ /" > /etc/apt/sources.list.d/akira-noble-riscv64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.12. Ubuntu 22.04 LTS "Jammy Jellyfish" (amd64)

To install Akira version 1.99 on Ubuntu 22.04 LTS "Jammy Jellyfish" (amd64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/jammy/22.04 LTS/amd64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/ubuntu/jammy/amd64/ /" > /etc/apt/sources.list.d/akira-jammy-amd64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.4.13. Ubuntu 22.04 LTS "Jammy Jellyfish" (arm64)

To install Akira version 1.99 on Ubuntu 22.04 LTS "Jammy Jellyfish" (arm64), follow these steps as the root user.

First, copy the OpenPGP key that apt uses to verify the release's deb package checksums into /usr/share/keyrings/:

# curl -o /usr/share/keyrings/akira-archive-keyring.gpg https://download.banu.com/packages/akira/1.99/jammy/22.04 LTS/arm64/akira-archive-keyring-2024-12-10.gpg

Then, add the Akira apt network package repository for your platform:

# echo "deb [signed-by=/usr/share/keyrings/akira-archive-keyring.gpg] https://download.banu.com/packages/akira/1.99/ubuntu/jammy/arm64/ /" > /etc/apt/sources.list.d/akira-jammy-arm64.list

Then, install the akira deb package that will install the Akira software and documentation:

# apt install akira

Then, if you wish to run Akira, configure akira suitably by editing /etc/akira/akira.conf, and then run it:

# systemctl enable --now akira

1.5. Upgrading

Please read the release notes before upgrading to a newer version of Akira --- see the chapter titled Release notes.