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 Nathan Base
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:
mkdir -p ~/nextcloud
cd ~/nextcloudDer 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:
openssl rand -hex 24Öffne mit nano .env die Datei für die Zugangsdaten und trag Folgendes ein:
NC_DOMAIN=cloud.deinedomain.de
NC_ADMIN_USER=admin
NC_ADMIN_PASSWORD=EIN_LANGES_ADMIN_PASSWORT
DB_PASSWORD=ERSTES_ZUFALLSPASSWORT
DB_ROOT_PASSWORD=ZWEITES_ZUFALLSPASSWORTErsetze 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:
chmod 600 .envSchritt 2: Die compose.yaml
Öffne mit nano compose.yaml die Compose-Datei und füge diesen Inhalt ein:
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/24Das 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-COMMITTEDist die Transaktionsstufe, die Nextcloud erwartet, und die größere Logdatei verhindert eine Warnung der Datenbankprüfung.MARIADB_AUTO_UPGRADEpasst 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_HOSTgesetzt ist. - app ist Nextcloud mit eingebautem Apache. Der Tag
35-apachehält Dich bewusst auf der Hauptversion 35, denn Nextcloud lässt sich nur eine Hauptversion nach der anderen aktualisieren. Mitlatestkönnte ein unbedachtespullzwei 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
appweiter.
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:
{
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:
docker compose up -dCompose 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:
docker compose logs -f appErscheinen 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:
docker compose exec -u www-data app php occ statusIn 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:
docker compose exec -u www-data app php occ config:system:set trusted_domains 2 --value=cloud.andere-domain.deDie 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:
docker compose exec -u www-data app php occ background:cronDie 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:
docker compose exec -u www-data app php occ config:system:set maintenance_window_start --type=integer --value=1Mimetype-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:
docker compose exec -u www-data app php occ maintenance:repair --include-expensiveFehlende Indizes in der Datenbank. Diese Meldung taucht meist nach einem Update auf. Der folgende Befehl legt sie an und meldet Done., wenn nichts fehlt:
docker compose exec -u www-data app php occ db:add-missing-indicesKeine 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:
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 aufAndereund wähleCalDAV-Account hinzufügen. Als Server trägst Ducloud.deinedomain.deein, dazu Deinen Benutzernamen und das App-Passwort. Für Kontakte geht es genauso unterEinstellungen > Apps > Kontakte > KontaktaccountsmitCardDAV-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-Accountund als AccounttypManuell. - 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/davan.
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:
docker compose pull
docker compose up -dCompose 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:
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.sqlDer 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:
docker compose exec -u www-data app php occ maintenance:mode --offWie 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 appzeigt, was los ist. Ein häufiger Grund ist ein nachträglich geändertesDB_PASSWORDin der.env: MariaDB legt Benutzer und Passwort nur beim allerersten Start an und behält das alte, während Nextcloud ohnehin das Passwort aus seinerconfig.phpnutzt. Lass das Passwort deshalb nach der Installation unverändert. - Die iPhone-Kalender-App findet den Server nicht: Rufe
https://cloud.deinedomain.de/.well-known/caldavim Browser auf. Landest Du nicht bei/remote.php/dav/, fehlen die beidenredir-Zeilen im Caddyfile oder Caddy hat sie noch nicht geladen. Eindocker compose restart caddyhilft.
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.
-
Selfhosting & WebReverse Proxy mit Caddy: HTTPS für Dienste im Heimnetz
Caddy als Reverse Proxy mit Docker: gültige Let's-Encrypt-Zertifikate für Home Assistant und Co. per DNS-Challenge, ohne Portfreigabe im Heimnetz.
Nathan Base -
Selfhosting & WebDocker Compose verstehen: Volumes, Netzwerke und .env
Docker Compose verständlich erklärt: Named Volume oder Bind Mount, Dienstnamen als Hostnamen, .env-Variablen, Healthchecks, sichere Updates und Backups.
Nathan Base -
Selfhosting & WebBackups mit restic: verschlüsselt auf S3 und Spaces
Server und Mac mit restic sichern: verschlüsselt, inkrementell und automatisch auf DigitalOcean Spaces oder anderen S3-Speicher, samt Restore.
Nathan Base -
Raspberry Pi & LinuxImmich installieren: iCloud-Fotos selbst hosten
Immich mit Docker auf Raspberry Pi 5 oder Mini-PC installieren, die Mediathek aus Apple Fotos importieren und das iPhone automatisch sichern.
Nathan Base -
Selfhosting & WebUptime Kuma einrichten: Websites und Dienste überwachen
Uptime Kuma 2 mit Docker Compose installieren, Websites und SSL-Zertifikate überwachen, per ntfy oder Telegram alarmieren und eine Statusseite anlegen.
Nathan Base -
Selfhosting & WebAnleitung: linkding mit Docker selbst hosten
linkding ist ein schlanker Bookmark-Manager zum Selbsthosten. So richtest Du ihn mit Docker Compose ein und verbindest die Browser-Erweiterung.
Nathan Base