grouprise consists of several components:

graph {
    rankdir = "TB"

        rank = "max"
        database [label = "Database"]
        media [label = "Media Storage"]
        rank = "same"
        django [label = "Django", shape = "box", style = "filled", width = "5"]
        rank = "same"
        uwsgi [label = "uWSGI"]
        worker [label = "Task Runner"]
        lmtp [label = "LMTP Server"]
        rank = "min"
        web_server [label = "Web Server"]
        mail_server [label = "Mail Server"]
        matrix_server [label = "Matrix Server"]

    web_server -- uwsgi -- django -- database [dir = "both"]
    worker -- django [dir = "both"]
    mail_server -- lmtp -- django [dir = "forward"]
    django -- matrix_server [dir = "forward"]
    django -- mail_server [dir = "forward"]
    media -- web_server [dir = "forward"]
    django -- media [dir = "both"]

grouprise uses the Django Framework for most of its operations.

Task Runner

A worker process executes periodic or time consuming tasks (e.g. sending email notifications). It is based on huey.


A database (e.g. PostgreSQL, MySQL or SQLite) is used for storing almost everything (except for media uploads).

Media Storage

Uploaded media (images, documents, …) are stored locally in the filesystem.


The uWSGI application server connects grouprise with the web server.

Web Server

The web server (e.g. apache2 or nginx) serves the content provided by grouprise to its users.

LMTP Server

The integrated LTMP server handles incoming mails and injects them into the grouprise application.

Mail Server

The external mail server (e.g. Postfix or Exim) delivers outgoing emails to external recipients and transfers incoming mails to the integrated LTMP Server.

Matrix Server

grouprise can send notifications into [Matrix]( chat rooms (see Matrix-Chat). In addition it is possible to manage grouprise content (e.g. delete spam, manage groups) by talking to the Matrix Commander (a chat bot).

The deployment based on deb packages configures most of these components.