< Go Back


The A2LN server runs on your Linux computer and is responsible for receiving notifications and displaying them using libnotify.


There are two ways to install the server.

Package Manager

The easiest way to install the server is to use pip or your system package manager. See this issue for the current status of packaging.

Distribution Command Note
PyPI (pip) python3 -m pip install a2ln No systemd user unit file
Arch Linux / Manjaro (AUR) git clone && cd a2ln && makepkg -sirc


First, clone the Git repository and check it out:

$ git clone
$ cd a2ln-server

For a user installation to ~/.local/bin, run:

$ make install

If you have not already, add the following to your shell configuration file which will add the installation directory to PATH.

export PATH="${PATH}:${HOME}/.local/bin"

System Installation

Alternatively, do a system installation:

$ sudo make install

Warning: This will install all dependencies and can therefore result in broken permissions and conflicting behaviour with the system package manager. To avoid the installation of dependencies, run this instead:

$ sudo make install FLAGS=--no-deps

This means that all dependencies must be installed by yourself, e.g. by using your system package manager.


After installation, simply run the server like this:

$ a2ln

This will start the server on the default port which is 23045.

To get an overview of all command line options, use:

$ a2ln -h


To automatically start the server at boot, the provided systemd user unit file can be used:

$ systemctl --user enable --now a2ln

Other options are:

Also take a look at this Arch Wiki article about autostarting.