02 How‐to install

Installation

This project consists of two components:

• authd: The authentication daemon responsible for managing access to the authentication mechanism.
• an identity broker: The services that handle the interface with an identity provider. There can be several identity brokers installed and enabled on the system.

authd

authd is delivered as a Debian package.

Note

While this project is in active development, a version for Ubuntu 24.04 is available from the authd testing PPA.
You can add this PPA to your system's software sources with the following commands:

sudo add-apt-repository ppa:ubuntu-enterprise-desktop/authd
sudo apt update

Install the following Debian packages (note that gnome-shell and yaru-theme* are only required for desktop integration, server installations may ignore them):

sudo apt install authd gnome-shell yaru-theme-gnome-shell

MS Entra ID broker

The brokers are provided as Snap packages and available from the Snap Store.

To install the MS Entra ID broker, run the following command:

sudo snap install authd-msentraid

At this stage, you have installed the main service and an identity broker to authenticate against Microsoft Entra ID.