Prosody package repository

We now have a repository of Prosody packages to allow for automatic updates using a package manager.

If you are using Debian, Ubuntu, or another derived GNU/Linux distribution that uses APT (apt, aptitude, etc.) then you can do the following:

Debian 12+

Download our combined sources and key file to /etc/apt/sources.list.d/:

sudo wget https://prosody.im/files/prosody.sources -O/etc/apt/sources.list.d/prosody.sources
sudo apt update

Debian 11+ using extrepo

On Debian 11 and later our repository can be enabled using extrepo like this:

sudo apt install extrepo
sudo extrepo enable prosody
sudo apt update

Then to install the Prosody package simply run:

sudo apt install prosody

Note: The prosody package is always kept up to date with the latest stable version of Prosody, including major releases. If your system upgrades packages automatically or you might not review Prosody release notes before upgrading, you may wish to disable automatic updates using e.g. apt-mark hold prosody, or install a branch-specific nightly build package (e.g. prosody-0.12) which only receives minor updates.

Other Debian based (e.g. Ubuntu)

For these systems the package manager needs a line of information about where to find the repository. For Prosody’s repository, this line is:

deb https://packages.prosody.im/debian VERSION main

You need to replace VERSION with the version of your distribution you are using. We currently support:

Distribution VERSION Alias
Debian 11 bullseye oldstable
Debian 12 bookworm stable
Debian unstable sid unstable
Ubuntu 20.04 LTS focal
Ubuntu 22.04 LTS jammy
Ubuntu 23.04 lunar
Ubuntu 23.10 mantic

The set of supported Debian and Ubuntu versions follow what Debian and Ubuntu support. You can find out which by running distro-info --supported.

If you are unsure which version your server is running, run the following command in a terminal:

lsb_release -sc

For other Debian or Ubuntu based distributions try to find out which version of Ubuntu or Debian it was based on and use that, otherwise you might need to experiment some.

Architectures

We currently build packages for these architectures:

amd64
Most modern machines.
i386
Older 32-bit machines. 1
arm64
Newer 64-bit Raspberry Pi and similar.
armhf
32-bit Raspberry Pi and similar.

You can check if this matches your machine by running dpkg --print-architecture.

Terminal

If you run one of the supported Ubuntu or Debian versions (see above), you can copy this line (select it, right-click, and choose Copy):

echo deb http://packages.prosody.im/debian $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/prosody.list

Now switch to your terminal and paste it (usually right-click→Paste or Ctrl+Shift+V).

Press enter, and enter your password if prompted.

Before you run apt update, you should import our key file, see the next section.

Adding our key file

In order to prevent warnings about unauthenticated packages, you can add our key file using the below command:

sudo wget https://prosody.im/files/prosody-debian-packages.key -O/etc/apt/trusted.gpg.d/prosody.gpg

Finally to have APT find our packages, run:

sudo apt update

Then to install the Prosody package simply run:

sudo apt install prosody

Graphical

Click ‘System’, then ‘Administration’. Select ‘Software Sources’.

Switch to the ‘Third-party Software’ tab. Click on the ‘Add’ button.

Into the box that opens, paste the line shown above beginning with ‘deb’.

Click ‘Add Source’ to close the dialog, and click ‘Reload’ if prompted.

You should now be able to install the ‘prosody’ package using Synaptic.

Adding our key file

Your system may warn you that the Prosody repository is not authenticated, or untrusted. To fix this you need to give it our key file.

Right-click on the link below and choose “Save Link As…”. Save the file to your desktop or home folder.

Prosody packages key.

Now back in the Software Sources manager, switch to the “Authentication” tab. Click on the “Import Key File” button. Select our key file you just downloaded, and click OK.


  1. The latest Ubuntu releases no longer support i386 and we are unable to build packages for this target anymore.↩︎