Discourse installieren: Anleitung für den eigenen Linux-Server

Discourse installieren ist deutlich einfacher, als der Funktionsumfang der Software vermuten lässt. Die moderne Open-Source-Forensoftware läuft vollständig in einem Docker-Container und lässt sich mit wenigen Befehlen auf einem eigenen Linux-Server einrichten. In dieser Schritt-für-Schritt-Anleitung zeigen wir dir, wie du Discourse von Grund auf aufsetzt, korrekt konfigurierst und per HTTPS absicherst – von den Voraussetzungen über Docker bis zum ersten Login als Administrator.

Discourse installieren: Die Voraussetzungen

Bevor du Discourse installierst, sollte dein Server einige Grundvoraussetzungen erfüllen. Discourse ist zwar ressourcenschonend, verlangt aber eine saubere Umgebung mit Docker und einer erreichbaren Domain:

Linux-Server: Discourse unterstützt offiziell vor allem Ubuntu 20.04 und 22.04, läuft aber auch auf anderen aktuellen Distributionen mit Docker-Unterstützung.
Hardware: moderne Single-Core-CPU (Dual-Core empfohlen), mindestens 1 GB RAM mit aktiviertem Swap (2 GB empfohlen), ein 64-Bit-System sowie rund 10 GB freier Speicherplatz.
Root- bzw. Sudo-Rechte: Du benötigst administrative Rechte, um Pakete zu installieren und Konfigurationen vorzunehmen.
Docker: Discourse kapselt alle Abhängigkeiten in einem Container. Docker muss daher vorhanden sein.
Offene Ports & öffentliche IP: Während des Setups prüft Discourse die Erreichbarkeit über die Domain. Die Ports 80 und 443 müssen offen sein.
Domain-Name: Du brauchst eine Domain oder Subdomain, z. B. forum.deinedomain.com.
SMTP-Relay: Für Registrierungen und Benachrichtigungen benötigt Discourse einen SMTP-Dienst zum Versand von E-Mails.

Als Unterbau eignet sich ein kleiner VPS ebenso wie eine virtuelle Maschine auf Proxmox oder ein Docker-fähiger Host auf Unraid. Wichtig ist vor allem, dass die Ports 80 und 443 aus dem Internet erreichbar sind.

Schritt 1: Linux-Server vorbereiten

Zuerst verbindest du dich per SSH mit deinem Server:

ssh user@dein-server-ip

System aktualisieren

Bringe zunächst alle Pakete auf den neuesten Stand, damit die Installation auf einer sauberen Basis aufsetzt:

sudo apt update
sudo apt upgrade

Docker installieren

Discourse setzt vollständig auf Docker, um Anwendung und Abhängigkeiten zu isolieren. Zuerst binden wir das offizielle Docker-APT-Repository ein:

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Anschließend installieren wir Docker samt Compose-Plugin:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Git installieren

Discourse benötigt zusätzlich Git, um sein Docker-Repository zu klonen:

sudo apt install git -y

Schritt 2: Discourse-Repository klonen

Jetzt klonen wir das offizielle Discourse-Docker-Repository nach /var/discourse und setzen die Berechtigungen:

sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
chmod 700 containers

Der Befehl klont das Repository nach /var/discourse/ und beschränkt mit chmod die Zugriffsrechte auf den Ordner containers.

Schritt 3: Das Discourse-Setup starten

Du solltest dich nun im Ordner /var/discourse befinden – das Setup lässt sich nur von hier ausführen. Falls nicht, wechsle mit cd /var/discourse dorthin. Anschließend startest du das interaktive Setup:

./discourse-setup

Das Skript stellt dir daraufhin einige Fragen zu Hostname, Admin-Adresse und SMTP-Zugangsdaten:

Hostname for your Discourse? [discourse.example.com]: 
Email address for admin account(s)? [[email protected],[email protected]]: 
SMTP server address? [smtp.example.com]: 
SMTP port? [587]: 
SMTP user name? [[email protected]]: 
SMTP password? [pa$$word]: 
Let's Encrypt account email? (ENTER to skip) [[email protected]]: 
Optional Maxmind License key () [xxxxxxxxxxxxxxxx]:

Wenn du beim Punkt Let’s Encrypt account email eine E-Mail-Adresse angibst, erhält dein Forum automatisch ein kostenloses HTTPS-Zertifikat. Das solltest du unbedingt einrichten, um deine Seite abzusichern.

Siehe auch Discourse Forum auf einen anderen Server migrieren

Das Setup erzeugt die Datei app.yml im Ordner /var/discourse/containers/ und startet anschließend das Bootstrapping.

Was ist Bootstrapping?

Bootstrapping bezeichnet den Prozess, bei dem ein System mit allen nötigen Ressourcen, Abhängigkeiten und Konfigurationen initialisiert und in einen betriebsbereiten Zustand überführt wird. Bei Container-Technologien wie Docker beschreibt der Begriff den ersten Einrichtungsschritt. Beim Discourse-Bootstrapping wird ein Docker-Container mit allen erforderlichen Komponenten – etwa Datenbank und Anwendungsdiensten – geladen und so eingerichtet, dass die Anwendung ohne manuelle Eingriffe startklar ist.

Das Bootstrapping dauert je nach Hardware zwischen 2 und 8 Minuten. Sobald es abgeschlossen ist, erreichst du dein Discourse-Forum bereits unter der zuvor festgelegten Domain.

Discourse-Weboberfläche nach der Installation

Nach der Installation: Erste Schritte

Rufe dein Forum jetzt im Browser über deine Domain auf und registriere dich mit der zuvor angegebenen Admin-E-Mail-Adresse. Discourse verschickt eine Bestätigungsmail – deshalb muss das SMTP-Setup zwingend funktionieren. Öffnest du die Bestätigung, erhält dein Konto automatisch Administratorrechte.

Anschließend führt dich ein Einrichtungsassistent durch die wichtigsten Grundeinstellungen wie Forennamen, Logo, Kategorien und Rechte. Updates spielst du später bequem über die Weboberfläche unter /admin/upgrade oder per ./launcher rebuild app ein.

Fazit

Discourse zu installieren erfordert nur wenige Schritte: Server vorbereiten, Docker und Git einrichten, das Repository klonen und das Setup ausführen. Dank des Docker-basierten Ansatzes bleibt das System sauber gekapselt und lässt sich einfach warten und aktualisieren. Wer eine erreichbare Domain, ein funktionierendes SMTP-Relay und ein gültiges HTTPS-Zertifikat einrichtet, hat in unter einer Stunde ein voll funktionsfähiges, modernes Community-Forum am Start.

Häufige Fragen zur Discourse-Installation

Wie viel RAM benötigt Discourse?

Discourse läuft mit mindestens 1 GB RAM, sofern zusätzlich Swap aktiviert ist. Für einen flüssigen Betrieb mit mehreren aktiven Nutzern werden jedoch 2 GB RAM oder mehr empfohlen.

Siehe auch Discourse Forum auf einen anderen Server migrieren

Kann ich Discourse ohne eigene Domain installieren?

Nein, eine Domain oder Subdomain ist praktisch Pflicht. Discourse prüft die Erreichbarkeit über die Domain und benötigt sie sowohl für das HTTPS-Zertifikat als auch für den zuverlässigen E-Mail-Versand.

Warum benötigt Discourse einen SMTP-Server?

Discourse verschickt Registrierungs-Bestätigungen, Passwort-Resets und Benachrichtigungen per E-Mail. Ohne funktionierendes SMTP-Relay kann sich niemand registrieren – auch nicht der erste Admin-Account.

Ist Docker für Discourse zwingend erforderlich?

Ja. Die einzige offiziell unterstützte Installationsmethode basiert auf Docker. Der Container bündelt alle Abhängigkeiten und macht Updates sowie Backups deutlich einfacher.

Wie lange dauert die Installation?

Die reine Einrichtung ist in wenigen Minuten erledigt. Das anschließende Bootstrapping des Docker-Containers dauert je nach Serverleistung zwischen 2 und 8 Minuten.

Wie aktualisiere ich Discourse später?

Kleinere Updates spielst du bequem über die Weboberfläche unter /admin/upgrade ein. Größere Updates führst du auf dem Server im Ordner /var/discourse mit ./launcher rebuild app aus.