FreshRSS per Docker installieren¶

Veröffentlicht am 30. Juli 2026 · Geschätzte Lesezeit: 3 Minuten

FreshRSS sammelt neue Beiträge aus Webseiten, Blogs und Projekten an einer Stelle. Du abonnierst dafür RSS- oder Atom-Feeds und liest sie in einer eigenen Weboberfläche, statt mehrere Seiten einzeln zu prüfen. Die integrierte Zeitsteuerung aktualisiert Feeds automatisch zweimal pro Stunde. Die Einrichtung dauert etwa 15 Minuten. Grundlage ist die offizielle FreshRSS-Docker-Dokumentation (Stand: 29. Juli 2026).

Voraussetzungen

Ein Linux-Server mit Docker und Docker Compose
Ein Benutzerkonto mit Berechtigung für Docker
Port 8081 im Heimnetz frei
Mindestens eine Webseite mit RSS- oder Atom-Feed zum Testen

1. Arbeitsordner anlegen¶

Führe die folgenden Befehle auf deinem Docker-Server aus. Die Unterordner bewahren Konfiguration, SQLite-Datenbank und Erweiterungen dauerhaft auf:

mkdir -p ~/freshrss/data ~/freshrss/extensions

cd ~/freshrss

2. Compose-Datei anlegen¶

Lege im Ordner ~/freshrss eine Datei namens compose.yaml an. CRON_MIN startet die Feed-Aktualisierung jeweils zur Minute 13 und 43 jeder Stunde:

services:
  freshrss:
    image: freshrss/freshrss:latest
    container_name: freshrss
    restart: unless-stopped
    ports:
      - "8081:80"
    environment:
      TZ: Europe/Berlin
      CRON_MIN: "13,43"
    volumes:
      - ./data:/var/www/FreshRSS/data
      - ./extensions:/var/www/FreshRSS/extensions
    logging:
      options:
        max-size: "10m"
    healthcheck:
      test: ["CMD", "cli/health.php"]
      timeout: 10s
      start_period: 60s
      interval: 75s
      retries: 3

Warum SQLite?

Für eine private Installation mit wenigen Benutzern reicht die integrierte SQLite-Datenbank meist aus. Du brauchst dadurch keinen zweiten Datenbank-Container und hast einen einfacheren Backup-Weg.

3. Konfiguration prüfen und starten¶

Prüfe die Compose-Datei im Ordner ~/freshrss:

docker compose config

Starte FreshRSS im Hintergrund:

docker compose up -d

Kontrolliere anschließend den Containerstatus:

docker compose ps

4. Einrichtungsassistent abschließen¶

Öffne http://<server-ip>:8081 im Browser und ersetze <server-ip> durch die feste IP-Adresse des Docker-Servers. Wähle im Assistenten Deutsch als Sprache.

Bei der Datenbank wählst du SQLite. Lege danach ein Administratorkonto mit einem eigenen Benutzernamen und einem starken, nur hier verwendeten Passwort an. Speichere das Passwort in einem Passwortmanager.

Nicht ohne HTTPS ins Internet stellen

Die Anmeldung läuft in dieser Anleitung über HTTP im Heimnetz. Öffne Port 8081 niemals per Router-Portfreigabe. Für Fernzugriff verwendest du ein VPN oder einen Reverse Proxy mit HTTPS.

5. Ersten Feed hinzufügen¶

Melde dich an und wähle Abonnementverwaltung → Feed hinzufügen. Trage die Adresse eines RSS- oder Atom-Feeds ein. Viele Webseiten erkennen den Feed auch dann, wenn du nur die normale Startseitenadresse einfügst.

Starte danach in FreshRSS eine manuelle Aktualisierung. Neue Beiträge sollten in der Hauptansicht erscheinen.

Interne Adressen bleiben gesperrt

FreshRSS blockiert Abrufe zu internen Hosts standardmäßig. Hebe diese Sperre nicht pauschal mit * oder 0.0.0.0/0 auf. Falls du später einen einzelnen lokalen Feed brauchst, erlaube nur genau dessen Host und Port.

6. Zeitsteuerung und Fehler prüfen¶

Der folgende Befehl zeigt die letzten Programmmeldungen. Führe ihn im Ordner ~/freshrss aus:

docker compose logs --tail=100 freshrss

Falls Feeds nicht aktualisiert werden, kontrolliere zuerst die Feed-Adresse, die Systemzeit des Servers und den Wert CRON_MIN. Ein Feed kann außerdem vorübergehend nicht erreichbar sein oder automatische Abrufe blockieren.

Prüfe die in FreshRSS angelegten Benutzer ohne Passwörter auszugeben:

docker compose exec --user www-data freshrss cli/list-users.php

7. Backup erstellen¶

Stoppe FreshRSS kurz, damit die SQLite-Datenbank einen konsistenten Stand hat:

docker compose down

Wechsle in deinen persönlichen Ordner:

cd ~

Sichere Compose-Datei, Datenbank, Einstellungen und Erweiterungen:

tar -czf freshrss-backup.tar.gz freshrss

Starte FreshRSS danach wieder:

cd ~/freshrss

docker compose up -d

Bewahre das Archiv geschützt auf. Es enthält Kontoinformationen, Feed-Abonnements und deinen Lesestatus.

8. Aktualisieren oder zurückbauen¶

Erstelle vor einem Update das Backup aus Schritt 7. Lade danach das aktuelle stabile Image und ersetze den Container:

docker compose pull

docker compose up -d

Bei Problemen stoppst du FreshRSS mit docker compose down, stellst den gesicherten Ordner wieder her und startest ihn erneut. Lösche die Ordner data und extensions nicht, solange du kein geprüftes Backup besitzt.

Fertig¶

FreshRSS läuft nun unter http://<server-ip>:8081 und aktualisiert deine Feeds zweimal pro Stunde. Die Einrichtung funktioniert, wenn ein Test-Feed Beiträge anzeigt und nach einer manuellen Aktualisierung neue Einträge erscheinen.