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

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 12	`bookworm`	`stable`
Debian testing	`trixie`	`testing`
Debian unstable	`sid`	`unstable`
Ubuntu 20.04 LTS	`focal`
Ubuntu 22.04 LTS	`jammy`

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. ¹
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.

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