# Deployment via "deb" packages

This guide helps you to install *grouprise* on [Debian](https://debian.org/) or one of its
derivatives (e.g. Ubuntu).
If you do not want to use a Debian-based system or wish to install *grouprise* manually, then you
should follow the [separate instructions for manual deployments](/deployment/source).

We would also like to support Docker deployments, but we do not have enough knowledge in that
specific domain and some reservations regarding security.
However we will happily accept documentation proposals on this matter, so feel free to open a
merge/pull request.

## Recommended Distributions

The following distributions work out of the box with the `deb` packages provided for *grouprise*:

* Debian Bookworm


## Distributions requiring adjustments

The following distribution should only be used, if the administrators feel confident to deal with
dependency issues on their own.

* Debian Bullseye
    * You need to install additional packages from Debian Bookworm (after temporarily adding this
      repository to `sources.list`):
        ```shell
        apt install -t bullseye python3-django-cachalot python3-django-taggit
        ```


## Installation with apt

You can install *grouprise* from our `deb` package repository.

Execute the following lines as root on the server host:

```shell
mkdir -p /etc/grouprise
touch /etc/grouprise/apt-keyring.gpg
wget -q -O - https://deb.grouprise.org/keys/repository.asc | gpg --no-default-keyring --keyring /etc/grouprise/apt-keyring.gpg --import
echo "deb [signed-by=/etc/grouprise/apt-keyring.gpg] https://deb.grouprise.org/ unstable main" >/etc/apt/sources.list.d/grouprise.list
apt update
apt install grouprise grouprise-db-postgresql
```

You will be prompted for some details during the package installation procedure.


## Database Initialization and Configuration

See [database initialization](/administration/database/initialization) for details.


## Configuration

This is outlined in the separate [configuration documentation](/administration/configuration/index).