Prosody IM Website


file download/package_repository.md in changeset ec3e4d0f0785

View latest ↓ Download file

line wrap: on
line source

---
title: 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-get, aptitude, etc.) then you can do the
following:

# Debian/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:

-   **Debian:** `buster`, `bullseye`, `sid`.
    -   Aliases: `unstable`, `stable`, `testing`.
-   **Ubuntu:** `bionic`, `focal`, `groovy`, `hirsute`
-   **Raspian:** (for Raspberry Pi) `buster`.

Architectures are `amd64` and `i386` for most 64 and 32 bit systems, and
Raspian which has `armhf` suitable for Raspberry Pi.

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:

``` {.bash}
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.

## Terminal

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

``` {.bash}
echo deb http://packages.prosody.im/debian $(lsb_release -sc) main | sudo tee -a /etc/apt/sources.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-get update, you should import our key file, see the
next section.

### Adding our key file {#adding_our_key_file}

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

``` {.bash}
wget https://prosody.im/files/prosody-debian-packages.key -O- | sudo apt-key add -
```

Finally to have APT find our packages, run:

``` {.bash}
sudo apt-get update
```

Then to install the Prosody package simply run:

``` {.bash}
sudo apt-get 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](https://help.ubuntu.com/community/SynapticHowto#Browsing%20the%20package%20database).

### Adding our key file {#adding_our_key_file1}

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](https://prosody.im/files/prosody-debian-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.