Miniflux mit Docker Compose: Schlanker RSS-Reader in 15 Minuten lokal gestartet

Wer wieder selbst kontrollieren will, welche Quellen täglich auflaufen, braucht kein aufgeblasenes Content-System. Miniflux ist bewusst klein, schnell und auf genau einen Job gebaut: RSS- und Atom-Feeds sauber einsammeln, lesen und abhaken.

Stand 2. April 2026 ist das Projekt für ein kleines Self-Hosting-Setup erfreulich klar dokumentiert. Die offizielle Docker-Doku empfiehlt ausdrücklich, keine ungepinnten Updates zu fahren, zeigt aktuell ein Compose-Beispiel mit PostgreSQL 18, und auf Docker Hub ist miniflux/miniflux:2.2.18 derzeit die neueste stabile Version.

Was du am Ende hast

Miniflux lokal unter http://localhost:8080
Einen Compose-Stack mit App und PostgreSQL
Einen Admin-Login für den ersten Start
Prüfschritte mit docker compose, Logs und curl

Voraussetzungen

Docker Engine und docker compose sind installiert
Port 8080 ist frei
Du startest in einem neuen Projektordner statt zwischen alten Compose-Dateien

1. Arbeitsordner anlegen

Sauber anfangen, dann erst Container starten:

mkdir miniflux-lab && cd miniflux-lab

2. Compose-Datei erstellen

Die offizielle Doku zeigt genau zwei Dienste: Miniflux und PostgreSQL. Für einen lokalen Start reicht das vollständig aus. Ich pinne hier die App bewusst auf 2.2.18, weil Miniflux selbst das Vermeiden von latest empfiehlt.

miniflux-lab/compose.yaml:

services:
  miniflux:
    image: miniflux/miniflux:2.2.18
    ports:
      - "8080:8080"
    depends_on:
      db:
        condition: service_healthy
    environment:
      DATABASE_URL: postgres://miniflux:secret@db/miniflux?sslmode=disable
      RUN_MIGRATIONS: "1"
      CREATE_ADMIN: "1"
      ADMIN_USERNAME: admin
      ADMIN_PASSWORD: change-this-now
    healthcheck:
      test: ["CMD", "/usr/bin/miniflux", "-healthcheck", "auto"]
      interval: 30s
      timeout: 10s
      retries: 3

  db:
    image: postgres:18
    environment:
      POSTGRES_USER: miniflux
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: miniflux
    volumes:
      - miniflux-db:/var/lib/postgresql
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "miniflux"]
      interval: 10s
      start_period: 30s

volumes:
  miniflux-db:

Wichtig ist hier der Volume-Pfad: Die Miniflux-Doku weist darauf hin, dass PostgreSQL 18 den Pfad /var/lib/postgresql nutzt, während PostgreSQL 17 und älter typischerweise /var/lib/postgresql/data verwenden.

3. Stack starten

Jetzt werden Images gezogen und der Stack im Hintergrund hochgefahren:

docker compose pull
docker compose up -d

Miniflux sollte danach unter dieser Adresse erreichbar sein:

http://localhost:8080

4. Funktion prüfen

Bevor du im Browser klickst, prüfst du einmal, ob Datenbank und App sauber stehen:

docker compose ps
docker compose logs --tail=100 miniflux
curl -I http://localhost:8080

Wenn alles sauber läuft, zeigt docker compose ps zwei laufende Dienste und curl liefert einen erfolgreichen HTTP-Status. Genau das ist der sichtbare Zwischenstand, den ein brauchbares Tutorial haben muss.

Öffne http://localhost:8080 und melde dich mit diesen Startdaten an:

Benutzername: admin
Passwort: change-this-now

Danach solltest du das Passwort sofort ändern. Für den ersten Test reichen dann schon ein oder zwei Feeds, zum Beispiel von einer Nachrichtenseite, einem Blog oder einem Release-Feed aus deinem Arbeitsbereich.

6. Warum Miniflux praktisch ist

Der Nutzen des Projekts liegt nicht in möglichst vielen bunten Extras, sondern in seiner Reduktion:

niedriger Ressourcenverbrauch
schneller lokaler Start
klare Weboberfläche statt Plugin-Chaos
gute Passform für Homelab, VPS oder kleine Team-Setups

Gerade wenn du wieder mehr direkte Quellen lesen willst statt nur Social-Feeds, ist das ein echter Alltagsgewinn.

7. Sinnvolle Betriebsbefehle

Für Alltag, Updates und Fehleranalyse brauchst du nur wenige Kommandos:

docker compose logs -f miniflux
docker compose pull
docker compose up -d
docker compose down

Die Datenbank bleibt im Volume miniflux-db erhalten.

8. Was du nach dem ersten Start aufräumen solltest

Die Miniflux-Doku nennt klar, dass die Admin-Erstellungsvariablen nur für die Initialisierung nötig sind. Nach dem ersten erfolgreichen Start solltest du deshalb in miniflux-lab/compose.yaml diese Werte wieder entfernen:

CREATE_ADMIN
ADMIN_USERNAME
ADMIN_PASSWORD

Zusätzlich solltest du das Datenbankpasswort ersetzen und den Stack nicht ungeschützt ins Internet hängen, bevor ein Reverse Proxy mit HTTPS davor sitzt.

Fazit

Wenn aktuelle News nicht sauber genug tragen, sollte der Fallback wenigstens ein reales Problem lösen. Genau das macht Miniflux: Du hast nach wenigen Minuten einen funktionierenden RSS-Reader im Browser, einen kleinen Compose-Stack und einen sichtbaren Endpunkt, den du sofort testen kannst.

Für 2. April 2026 ist das ein deutlich brauchbarerer Artikel als noch ein abstrakter Docker-Grundlagenpost ohne Ergebnis.

User Dashboard