Zum Inhalt springen
SONOYA.com
Selfhosting & Web

Nextcloud mit Docker Compose installieren und absichern

Nextcloud mit Docker Compose, MariaDB, Redis und Caddy selbst hosten: mit HTTPS, Cron, Kalender und Kontakten fürs iPhone und Hilfe bei den Warnungen.

Von

Drei verbundene Kreise wie im Nextcloud-Logo auf dunkelgrünem Grund, als Sinnbild für die eigene Cloud mit Dateien, Kalender und Kontakten

Du willst Deine Dateien, Kalender und Kontakte nicht mehr bei Dropbox, Google oder iCloud lagern, sondern auf einem eigenen Server. Nextcloud kann genau das, nur scheitert die Installation oft an drei Stellen: an der Datenbank, am Reverse Proxy und an der langen Liste gelber Warnungen, die Nextcloud nach dem ersten Login in der Verwaltung zeigt.

Diese Anleitung baut eine komplette Nextcloud mit Docker Compose auf: Nextcloud selbst, MariaDB als Datenbank, Redis als Cache, einen eigenen Container für die Hintergrundjobs und Caddy, der das HTTPS-Zertifikat besorgt. Die Konfiguration ist so gewählt, dass die typischen Warnungen gar nicht erst entstehen, und für die übrigen bekommst Du den passenden Befehl.

Nextcloud AIO oder eigenes Compose?

Nextcloud bietet zwei Wege mit Docker an. Nextcloud All-in-One (AIO) ist die offizielle Installationsmethode der Nextcloud GmbH: Ein Master-Container mit eigener Weboberfläche startet und verwaltet alle anderen Container, bringt Nextcloud Office, Talk und eine Backup-Lösung auf Basis von BorgBackup mit und braucht dafür Zugriff auf den Docker-Socket. Das ist bequem, aber was dort passiert, siehst Du kaum.

Das Community-Image nextcloud ist ein ganz normales Image, das Du wie jeden anderen Dienst in eine compose.yaml schreibst. Laut seiner Beschreibung pflegen es Freiwillige, und es richtet sich an erfahrene Nutzer. Betreibst Du schon andere Dienste mit Docker Compose, ist das der passende Weg: Du siehst jede Einstellung, sicherst alles nach demselben Muster und aktualisierst, wann Du willst. Diesen Weg gehen wir hier. Willst Du nur eine fertige Nextcloud mit Office-Paket, nimm AIO.

Was Du brauchst

  • Einen Linux-Server mit 2 GB RAM oder mehr und Docker samt Compose-Plugin, etwa ein Ubuntu-Droplet bei DigitalOcean (Affiliate Link) oder einen Mini-PC mit N100 (Affiliate Link) zu Hause. Docker installierst Du nach der offiziellen Anleitung für Ubuntu.
  • Eine eigene Domain mit einem A-Eintrag, der auf die öffentliche IP-Adresse des Servers zeigt. Hier steht dafür der Platzhalter cloud.deinedomain.de.
  • Offene Ports 80 und 443, damit Caddy das Zertifikat bei Let’s Encrypt abholen kann und Deine Geräte von unterwegs hinkommen.

Steht der Server bei Dir zu Hause und Dein Anschluss hat keine eigene öffentliche IPv4-Adresse, zeigt DS-Lite und CGNAT: Server trotzdem erreichbar machen, wie Deine Geräte ihn von unterwegs erreichen. Auf einem frischen VPS lohnt sich vorher ein Blick in Linux-Server absichern: SSH-Schlüssel, ufw, fail2ban. Gib in ufw dann die Ports 80 und 443 frei.

Getestet ist der komplette Aufbau mit Nextcloud 35.0.3, MariaDB 12.3.3, Redis 8.10 und Caddy 2.11.9 unter Docker Engine 29.9 und Docker Compose 5.7 auf ARM64, mit einem Zertifikat aus Caddys interner Zertifizierungsstelle statt von Let’s Encrypt, weil die Testumgebung keine öffentliche Domain hatte.

Schritt 1: Ordner und Passwörter anlegen

Melde Dich per SSH auf dem Server an und lege einen Ordner für Nextcloud an:

Code
mkdir -p ~/nextcloud
cd ~/nextcloud

Der Ordnername ist wichtig, denn Docker Compose benutzt ihn als Projektnamen und stellt ihn den Volumes voran. Aus dem Volume nextcloud wird so nextcloud_nextcloud, das brauchst Du später beim Backup.

Für die Datenbank brauchst Du zwei zufällige Passwörter. Diesen Befehl führst Du zweimal aus und kopierst die Ausgaben:

Code
openssl rand -hex 24

Öffne mit nano .env die Datei für die Zugangsdaten und trag Folgendes ein:

Code
NC_DOMAIN=cloud.deinedomain.de
NC_ADMIN_USER=admin
NC_ADMIN_PASSWORD=EIN_LANGES_ADMIN_PASSWORT
DB_PASSWORD=ERSTES_ZUFALLSPASSWORT
DB_ROOT_PASSWORD=ZWEITES_ZUFALLSPASSWORT

Ersetze die Domain durch Deine, wähle einen Namen und ein starkes Passwort für das Admin-Konto und setze die beiden Zufallspasswörter ein. Speichere mit Strg + O, bestätige mit Enter und schließe den Editor mit Strg + X. Danach darf nur noch Dein Benutzer die Datei lesen:

Code
chmod 600 .env

Schritt 2: Die compose.yaml

Öffne mit nano compose.yaml die Compose-Datei und füge diesen Inhalt ein:

Code
services:
  db:
    image: mariadb:12.3
    restart: unless-stopped
    command: --transaction-isolation=READ-COMMITTED --innodb-log-file-size=128M
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: ${DB_PASSWORD}
      MARIADB_AUTO_UPGRADE: "1"
    volumes:
      - db:/var/lib/mysql
    networks:
      - nextcloud

  redis:
    image: redis:8-alpine
    restart: unless-stopped
    networks:
      - nextcloud

  app:
    image: nextcloud:35-apache
    restart: unless-stopped
    depends_on:
      - db
      - redis
    environment:
      MYSQL_HOST: db
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: ${DB_PASSWORD}
      REDIS_HOST: redis
      NEXTCLOUD_ADMIN_USER: ${NC_ADMIN_USER}
      NEXTCLOUD_ADMIN_PASSWORD: ${NC_ADMIN_PASSWORD}
      NEXTCLOUD_TRUSTED_DOMAINS: ${NC_DOMAIN}
      OVERWRITEPROTOCOL: https
      OVERWRITECLIURL: https://${NC_DOMAIN}
      TRUSTED_PROXIES: 172.30.42.0/24
      APACHE_DISABLE_REWRITE_IP: "1"
      PHP_UPLOAD_LIMIT: 10G
      PHP_MEMORY_LIMIT: 1G
    volumes:
      - nextcloud:/var/www/html
    networks:
      - nextcloud

  cron:
    image: nextcloud:35-apache
    restart: unless-stopped
    entrypoint: /cron.sh
    depends_on:
      - app
    volumes:
      - nextcloud:/var/www/html
    networks:
      - nextcloud

  caddy:
    image: caddy:2
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
    networks:
      - nextcloud

volumes:
  db:
  nextcloud:
  caddy_data:
  caddy_config:

networks:
  nextcloud:
    ipam:
      config:
        - subnet: 172.30.42.0/24

Das sind fünf Dienste, und jeder hat eine klare Aufgabe:

  • db ist MariaDB 12.3, die Version, die das Admin-Handbuch in den Systemanforderungen empfiehlt. READ-COMMITTED ist die Transaktionsstufe, die Nextcloud erwartet, und die größere Logdatei verhindert eine Warnung der Datenbankprüfung. MARIADB_AUTO_UPGRADE passt die internen Tabellen von MariaDB an, wenn Du später auf eine neuere MariaDB-Version wechselst. PostgreSQL 18 wäre genauso unterstützt, MariaDB nutzen aber auch die offiziellen Beispiele des Images.
  • redis übernimmt Dateisperren und Cache. Das Image trägt Redis selbst in die Konfiguration ein, sobald REDIS_HOST gesetzt ist.
  • app ist Nextcloud mit eingebautem Apache. Der Tag 35-apache hält Dich bewusst auf der Hauptversion 35, denn Nextcloud lässt sich nur eine Hauptversion nach der anderen aktualisieren. Mit latest könnte ein unbedachtes pull zwei Versionen überspringen.
  • cron nutzt dasselbe Image und dasselbe Volume, startet aber statt Apache das Skript /cron.sh, das alle fünf Minuten die Hintergrundjobs ausführt.
  • caddy nimmt die Anfragen auf Port 80 und 443 an, holt das Zertifikat und reicht alles an app weiter.

Das eigene Netz mit dem festen Bereich 172.30.42.0/24 hat einen Grund: Nextcloud soll Caddy als vertrauenswürdigen Proxy kennen, und dafür braucht TRUSTED_PROXIES einen festen Adressbereich. Zusammen mit APACHE_DISABLE_REWRITE_IP liest Nextcloud die echte IP-Adresse Deiner Geräte aus dem Header X-Forwarded-For, statt jede Anfrage Caddy zuzuschreiben. Das ist wichtig für den Schutz gegen das Durchprobieren von Passwörtern, der sonst Caddy selbst ausbremsen würde. Falls sich der Bereich mit einem Netz auf Deinem Server überschneidet, wählst Du einen anderen privaten Bereich und änderst ihn an beiden Stellen.

PHP_UPLOAD_LIMIT erlaubt Uploads bis 10 GB über den Browser. Die Desktop- und Mobil-Apps laden große Dateien ohnehin in Stücken hoch. Was die einzelnen Bausteine wie volumes und networks genau bedeuten, erklärt Docker Compose verstehen: Volumes, Netzwerke und .env.

Schritt 3: Caddy mit HTTPS und den DAV-Weiterleitungen

Leg mit nano Caddyfile die Konfiguration für Caddy an:

Code
{
	email [email protected]
}

cloud.deinedomain.de {
	header Strict-Transport-Security "max-age=31536000; includeSubDomains"
	redir /.well-known/carddav /remote.php/dav/ 301
	redir /.well-known/caldav /remote.php/dav/ 301
	reverse_proxy app:80
}

Ersetze die E-Mail-Adresse und die Domain durch Deine. Caddy holt das Zertifikat für diese Domain beim ersten Aufruf selbst und erneuert es automatisch. Die Zeile header setzt HSTS, ohne die Nextcloud später eine Sicherheitswarnung zeigt. Die beiden redir-Zeilen leiten die Adressen weiter, unter denen Kalender- und Kontakt-Apps nach dem Server suchen. Laut Doku zur Reverse-Proxy-Konfiguration muss das hinter einem Proxy der Proxy übernehmen, weil die Weiterleitungen von Nextcloud selbst dort nicht greifen.

Betreibst Du Caddy bereits für andere Dienste, wie in Reverse Proxy mit Caddy: HTTPS für Dienste im Heimnetz beschrieben, lässt Du den Dienst caddy hier weg, hängst app zusätzlich in das Netz proxy und trägst den Block von oben in Dein bestehendes Caddyfile ein. TRUSTED_PROXIES muss dann den Adressbereich des Netzes proxy enthalten, den Dir docker network inspect proxy unter Subnet zeigt.

Schritt 4: Erster Start und Anmeldung

Starte alle Container:

Code
docker compose up -d

Compose lädt die Images und startet die Dienste. Beim ersten Start richtet sich Nextcloud mit den Werten aus der .env selbst ein, legt das Admin-Konto an und trägt Domain, Proxy und Redis in seine Konfiguration ein. Das dauert ein bis zwei Minuten. Verfolge es im Log:

Code
docker compose logs -f app

Erscheinen die Zeilen Nextcloud was successfully installed und kurz darauf resuming normal operations, ist die Installation fertig. Beende die Anzeige mit Strg + C. Ob alles läuft, prüfst Du mit dem Verwaltungswerkzeug occ, das immer als Benutzer www-data laufen muss:

Code
docker compose exec -u www-data app php occ status

In der Ausgabe muss installed: true stehen, dazu die Version 35.0.3 oder neuer. Jetzt öffnest Du https://cloud.deinedomain.de im Browser und meldest Dich mit dem Admin-Konto an.

Wichtig: Die Variablen für Domain, Proxy und Admin-Konto wirken nur bei der allerersten Installation. Änderst Du sie später in der .env, passiert nichts, denn Nextcloud hat sie längst in seine eigene Datei config.php im Volume geschrieben. Das Admin-Passwort kannst Du deshalb nach dem ersten Start aus der .env löschen. Eine weitere Domain trägst Du nachträglich mit occ ein:

Code
docker compose exec -u www-data app php occ config:system:set trusted_domains 2 --value=cloud.andere-domain.de

Die Nummer am Ende ist der Platz in der Liste. Auf Platz 0 steht localhost, auf Platz 1 Deine Domain aus der Installation, also nimmst Du für den nächsten Eintrag die 2. Mit occ config:system:get trusted_domains siehst Du die ganze Liste. Die Meldung „Zugriff über eine nicht vertrauenswürdige Domain“ bedeutet genau das: Der Name, mit dem Du Nextcloud aufrufst, fehlt in dieser Liste.

Hintergrundjobs: Cron statt AJAX

Von sich aus erledigt Nextcloud Hintergrundarbeiten im Modus AJAX, also nur dann, wenn gerade jemand eine Seite im Browser lädt. Die Doku zu den Hintergrundjobs empfiehlt stattdessen Cron. Das erledigt der Container cron bereits, und beim ersten Lauf stellt Nextcloud den Modus selbst um. Damit es von Anfang an stimmt, setzt Du ihn trotzdem einmal ausdrücklich:

Code
docker compose exec -u www-data app php occ background:cron

Die Antwort lautet Set mode for background jobs to 'cron'. In der Verwaltung unter Administrationseinstellungen > Grundeinstellungen im Abschnitt Hintergrundaufgaben siehst Du einige Minuten später, wann der letzte Job gelaufen ist.

Die Warnungen in der Verwaltung beheben

Unter Administrationseinstellungen > Übersicht prüft Nextcloud die Installation. Mit dem Aufbau von oben fallen viele typische Meldungen schon weg: Die Datenbank läuft mit der richtigen Transaktionsstufe, Redis sperrt die Dateien, HSTS und die Weiterleitungen für CalDAV und CardDAV kommen von Caddy, und die echte IP-Adresse kommt dank TRUSTED_PROXIES an. Im Test blieben nach der Installation diese Hinweise übrig, und fast jeder ist mit einem Befehl erledigt.

Kein Wartungsfenster festgelegt. Nextcloud möchte wissen, wann es aufwendige tägliche Jobs ausführen darf. Der Wert ist eine Stunde in UTC, 1 bedeutet laut Doku die Zeit zwischen 01:00 und 05:00 Uhr UTC:

Code
docker compose exec -u www-data app php occ config:system:set maintenance_window_start --type=integer --value=1

Mimetype-Migrationen verfügbar. Nextcloud kennt neue Dateitypen, ordnet bestehende Dateien aber nicht von selbst neu zu, weil das auf großen Installationen lange dauert. Auf einer frischen Installation geht es schnell:

Code
docker compose exec -u www-data app php occ maintenance:repair --include-expensive

Fehlende Indizes in der Datenbank. Diese Meldung taucht meist nach einem Update auf. Der folgende Befehl legt sie an und meldet Done., wenn nichts fehlt:

Code
docker compose exec -u www-data app php occ db:add-missing-indices

Keine Standard-Telefonregion. Ohne sie lehnt Nextcloud im Profil Telefonnummern ohne Ländervorwahl ab. DE ist der Ländercode für Deutschland, für Österreich nimmst Du AT, für die Schweiz CH:

Code
docker compose exec -u www-data app php occ config:system:set default_phone_region --value="DE"

E-Mail-Server nicht eingerichtet. Damit Nextcloud Einladungen und Passwort-Links verschicken kann, trägst Du unter Administrationseinstellungen > Grundeinstellungen die SMTP-Daten Deines Mail-Anbieters ein und testest sie mit E-Mail senden.

Drei Hinweise darfst Du auf einem einzelnen Server ignorieren: den fehlenden Standard-Deploy-Daemon für AppAPI, der nur für externe Apps nötig ist, die fehlende Server-ID, die erst bei mehreren PHP-Servern zählt, und den Hinweis, dass Zwei-Faktor-Anmeldung nicht erzwungen wird. Die Zwei-Faktor-Anmeldung solltest Du für Dein eigenes Konto trotzdem unter Persönliche Einstellungen > Sicherheit einschalten. Lädst Du die Übersicht neu und die Datenbankprüfung meldet weiter einen Fehler, warte ein paar Minuten, denn Nextcloud speichert deren Ergebnis zwischen.

Apps für Mac, iPhone und Android

Für Deine Dateien lädst Du die offiziellen Apps von der Download-Seite von Nextcloud: den Desktop-Client für macOS, Windows und Linux sowie die Apps für iPhone und Android. Beim Anmelden gibst Du jeweils nur https://cloud.deinedomain.de ein, die App öffnet dann den Browser, in dem Du den Zugriff bestätigst.

Kalender und Kontakte laufen dagegen über CalDAV und CardDAV direkt in den Apps Deines Geräts. Lege dafür in Nextcloud unter Persönliche Einstellungen > Sicherheit > Geräte & Sitzungen je Gerät ein eigenes App-Passwort an, statt Dein Kontopasswort zu verwenden. Geht ein Gerät verloren, sperrst Du nur dessen App-Passwort.

  • iPhone: Öffne laut Apples iPhone-Handbuch Einstellungen > Apps > Kalender > Kalender-Accounts > Account hinzufügen, tippe auf Andere und wähle CalDAV-Account hinzufügen. Als Server trägst Du cloud.deinedomain.de ein, dazu Deinen Benutzernamen und das App-Passwort. Für Kontakte geht es genauso unter Einstellungen > Apps > Kontakte > Kontaktaccounts mit CardDAV-Account hinzufügen. Dass Du nur die Domain brauchst und keinen langen Pfad, liegt an den beiden Weiterleitungen im Caddyfile.
  • Mac: In der App Kalender wählst Du laut Apple Kalender > Account hinzufügen > Anderer CalDAV-Account und als Accounttyp Manuell.
  • Android: Die Nextcloud-Doku zur Android-Synchronisation empfiehlt die App DAVx⁵. Dort wählst Du die Anmeldung mit URL und Benutzernamen und gibst als Adresse https://cloud.deinedomain.de/remote.php/dav an.

Fotos sichern die Nextcloud-Apps ebenfalls automatisch. Wer eine Fotoverwaltung mit Gesichtserkennung und Zeitleiste wie bei Google Fotos sucht, ist mit einem eigenen Dienst besser bedient, siehe Immich installieren: iCloud-Fotos selbst hosten.

Updates ohne Überraschungen

Für Updates innerhalb der Version 35 reichen zwei Befehle im Ordner ~/nextcloud:

Code
docker compose pull
docker compose up -d

Compose lädt die neuesten Images mit dem Tag 35-apache und startet die geänderten Container neu. Das Startskript im Container erkennt, dass die Version im Volume älter ist als die im Image, und führt das Upgrade selbst aus. Deine Daten bleiben dabei erhalten, weil sie im Volume liegen und nicht im Container. Danach lässt Du einmal occ db:add-missing-indices laufen.

Für den Sprung auf die nächste Hauptversion änderst Du in der compose.yaml bei app und cron den Tag von 35-apache auf 36-apache, am besten erst, wenn die neue Version ein paar Wochen alt ist und Deine installierten Apps sie unterstützen. Laut Beschreibung des Images geht nur eine Hauptversion pro Schritt. Die aktuellen Versionen findest Du auf der Release-Seite von Nextcloud. Bevor Du die Hauptversion wechselst, machst Du ein Backup.

Das Backup: Datenbank und Volume

Ein vollständiges Backup besteht aus zwei Teilen: einem Abzug der Datenbank und dem Volume mit Dateien und Konfiguration. Damit beides zusammenpasst, schaltest Du Nextcloud kurz in den Wartungsmodus:

Code
docker compose exec -u www-data app php occ maintenance:mode --on
docker compose exec db sh -c 'mariadb-dump --single-transaction -u nextcloud -p"$MYSQL_PASSWORD" nextcloud' > nextcloud-db.sql

Der zweite Befehl schreibt die komplette Datenbank in die Datei nextcloud-db.sql im aktuellen Ordner. Das Passwort liest er aus der Umgebung des Containers, Du musst es also nicht eintippen. Sichere jetzt die Datei und das Volume nextcloud_nextcloud, das unter /var/lib/docker/volumes/nextcloud_nextcloud/_data liegt. Danach schaltest Du den Wartungsmodus wieder aus:

Code
docker compose exec -u www-data app php occ maintenance:mode --off

Wie Du beides verschlüsselt und automatisch auf einen S3-Speicher bringst, zeigt Backups mit restic: verschlüsselt auf S3 und Spaces. Ein Hinweis noch: Lösche Dein Projekt nie mit docker compose down -v, wenn Du es nur neu starten willst. Der Zusatz -v entfernt die Volumes und damit alle Dateien und die Datenbank.

Wenn etwas nicht klappt

  • Caddy bekommt kein Zertifikat: Prüfe mit docker compose logs caddy, ob der A-Eintrag der Domain schon auf den Server zeigt und Port 80 von außen erreichbar ist. Ohne Port 80 scheitert die Prüfung durch Let’s Encrypt.
  • Fehler 502 im Browser: Nextcloud richtet sich noch ein oder kommt nicht an die Datenbank. docker compose logs app zeigt, was los ist. Ein häufiger Grund ist ein nachträglich geändertes DB_PASSWORD in der .env: MariaDB legt Benutzer und Passwort nur beim allerersten Start an und behält das alte, während Nextcloud ohnehin das Passwort aus seiner config.php nutzt. Lass das Passwort deshalb nach der Installation unverändert.
  • Die iPhone-Kalender-App findet den Server nicht: Rufe https://cloud.deinedomain.de/.well-known/caldav im Browser auf. Landest Du nicht bei /remote.php/dav/, fehlen die beiden redir-Zeilen im Caddyfile oder Caddy hat sie noch nicht geladen. Ein docker compose restart caddy hilft.

Mit diesem Aufbau hast Du eine Nextcloud, die Dateien, Kalender und Kontakte zwischen allen Geräten abgleicht und deren Konfiguration vollständig in drei kleinen Dateien steht. Wenn Dir noch ein Server fehlt, bekommst Du über diesen Link zu DigitalOcean (Affiliate Link) Startguthaben, um das Ganze erst einmal auszuprobieren.

Weiterlesen.