Nextcloud ist deine eigene Cloud für Dateien, Kalender und Kontakte, auf deinem Server statt bei einem Anbieter. In diesem Projekt baust du sie auf Debian 13 in einem eigenen Proxmox-Container auf: mit Datenbank, Zwischenspeicher, HTTPS über einen Reverse Proxy, Zwei-Faktor-Login und Backup.
ca. 2–4 Stunden Linux und Proxmox-Grundlagen Debian 13 · PHP 8.4 · MariaDB 11.8
Daten-Volume/srv/nextcloud-data im Proxmox-Backup enthalten
Alle Adressen in dieser Anleitung sind Beispiele: cloud.example.org für die Domain, 10.20.30.201 für den Nextcloud-Container und 10.20.30.10 für den Reverse Proxy.
Die Entscheidungen und warum
Frage
Entscheidung
Begründung
Betriebssystem
Debian 13 („trixie“)
Wird von Nextcloud unterstützt und liefert PHP 8.4 und MariaDB 11.8 aus den eigenen Paketquellen. Nach den Systemanforderungen der Nextcloud-Dokumentation (Stand September 2026) sind PHP 8.3 bis 8.5 und MariaDB 11.8 freigegeben. Prüfe die Anforderungen deiner Version vor der Installation.
Container oder VM
Unprivilegierter LXC-Container
Sparsam, schnell gesichert und in Sekunden gestartet. Eine VM lohnt sich, wenn du einen eigenen Kernel oder stärkere Trennung brauchst.
Aufteilung
Alles in einem Container
Apache, PHP, MariaDB und Redis zusammen sind einfach zu betreiben und zu sichern, gut für Familie und kleine Teams. Bei Wachstum lässt sich die Datenbank später trennen.
Installationsweg
Offizielles Archiv (tar.bz2)
Volle Kontrolle ohne Zusatzschicht, Updates über den eingebauten Updater. Alternativen sind Nextcloud All-in-One (Docker) oder Snap.
Webserver
Apache mit mod_php
Einfach und für kleine Installationen ausreichend. Die Nextcloud-Dokumentation nennt php-fpm als Alternative für höhere Last.
HTTPS
Am Reverse Proxy
Zertifikate laufen an einer Stelle zusammen und erneuern sich dort. Der Container spricht intern HTTP.
1Container in Proxmox anlegen
Lade die Debian-13-Vorlage und lege den Container an. Der Name der Vorlage steht in der Ausgabe von pveam available, er ändert sich mit neuen Debian-Zwischenversionen.
Am Proxmox-Host
pveam update
pveam available --section system | grep debian-13
pveam download local debian-13-standard_13.6-1_amd64.tar.zst
Die wichtigsten Angaben: --unprivileged 1 trennt den Container vom Host, --features nesting=1 verhindert, dass systemd-Sandboxing einzelner Dienste (Apache, MariaDB, Redis) bei neueren systemd-Versionen mit „Systemd ... You may need to enable nesting" scheitert, --rootfs ist das System (16 GB), --mp0 ein eigenes Volume für die Nextcloud-Daten (hier 100 GB, passe es an). Mit backup=1 nimmt der Backup-Job das Volume mit. Bridge, IP-Adresse, Gateway und DNS-Server passt du an dein Netz an.
So erkennst du, dass es klappt
pct enter 201 öffnet eine Shell im Container. cat /etc/debian_version zeigt eine Version 13.x, df -h /srv/nextcloud-data das eigene Volume und ping -c1 deb.debian.org beweist, dass das Netz funktioniert.
2Grundeinrichtung im Container
Ab hier arbeitest du im Container (pct enter 201). Bringe das System auf den neuesten Stand und stelle die Zeitzone ein.
Zu den Pflichtmodulen der Nextcloud-Dokumentation gehören curl, gd, mbstring, xml, zip und ein Datenbank-Treiber (mysql). Die anderen sind empfohlen: intl, bcmath und gmp für zusätzliche Funktionen, apcu und redis für den Zwischenspeicher, imagick für Vorschaubilder. Module wie posix, ctype, dom, fileinfo und zlib bringt PHP schon mit.
So erkennst du, dass es klappt
php -v zeigt PHP 8.4, mariadb --version eine 11.8er Version und systemctl is-active apache2 mariadb redis-server dreimal active.
4Datenbank anlegen
Nextcloud bekommt eine eigene Datenbank und einen eigenen Benutzer, der nur dort Rechte hat. Erzeuge zuerst ein langes Zufallspasswort und notiere es im Passwortmanager:
Im Container
openssl rand -base64 24
Im Container (als root, Anmeldung über den Socket)
mariadb
CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'nextcloud'@'localhost' IDENTIFIED BY 'HIER-DAS-ZUFALLSPASSWORT';
GRANT ALL PRIVILEGES ON nextcloud.* TO 'nextcloud'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Hinweis
Debian lässt MariaDB nur auf 127.0.0.1 lauschen. Die Datenbank ist also von außerhalb des Containers nicht erreichbar, das soll so bleiben.
5PHP einstellen
Die Nextcloud-Dokumentation empfiehlt für memory_limit mindestens 512 MB, und Nextcloud profitiert vom OPcache. Lege eine eigene Datei an, damit Updates von PHP sie nicht überschreiben:
Für die Befehlszeile (occ) muss der APCu-Speicher ebenfalls eingeschaltet sein:
/etc/php/8.4/cli/conf.d/90-nextcloud.ini
apc.enable_cli = 1
Hinweis
Meldet die Übersicht in Nextcloud später etwa OPcache interned strings buffer als fast voll, erhöhst du dort den Wert opcache.interned_strings_buffer (zum Beispiel auf 16). Nextcloud zeigt Hinweise dieser Art unter Verwaltungseinstellungen → Übersicht an.
6Nextcloud laden und prüfen
Lade das Archiv vom offiziellen Server und prüfe zwei Dinge, bevor du es auspackst: die Prüfsumme (ist die Datei vollständig?) und die Signatur (stammt sie wirklich von Nextcloud?).
Der Schlüssel muss diesen Fingerabdruck haben (Ausschnitt aus der Ausgabe von gpg --fingerprint "Nextcloud Security"). Vergleiche ihn mit dem Wert auf der Website von Nextcloud:
Die erste Prüfung zeigt latest.tar.bz2: OK. Die zweite meldet Good signature from "Nextcloud Security <security@nextcloud.com>" mit dem oben genannten Fingerabdruck. Die Warnung „This key is not certified with a trusted signature“ ist normal, denn du hast den Schlüssel nicht selbst beglaubigt. Wichtig sind Good signature und der richtige Fingerabdruck. Bei einer veränderten Datei meldet gpg BAD signature, dann brich ab.
Erst jetzt auspacken, Rechte setzen und das Datenverzeichnis vorbereiten:
Das Datenverzeichnis liegt bewusst außerhalb des Webordners /var/www, damit nie jemand Dateien direkt über den Webserver abrufen kann.
7Apache einrichten
Aktiviere die benötigten Module, lege einen eigenen Host für Nextcloud an und schalte die Standardseite ab. Wichtig ist AllowOverride All: Nextcloud bringt eine .htaccess mit, die Sicherheits-Header und Weiterleitungen setzt.
Im Container
a2enmod rewrite headers env dir mime remoteip
a2dissite 000-default
/etc/apache2/sites-available/nextcloud.conf
<VirtualHost *:80>
ServerName cloud.example.org
DocumentRoot /var/www/nextcloud
<Directory /var/www/nextcloud/>
Require all granted
AllowOverride All
Options FollowSymLinks MultiViews
<IfModule mod_dav.c>
Dav off
</IfModule>
</Directory>
ErrorLog ${APACHE_LOG_DIR}/nextcloud-error.log
CustomLog ${APACHE_LOG_DIR}/nextcloud-access.log combined
</VirtualHost>
Hinter dem Reverse Proxy sähe jeder Besucher im Log wie der Proxy aus. Mit remoteip übernimmt Apache die echte Adresse aus dem Header, aber nur, wenn die Anfrage vom Proxy kommt:
/etc/apache2/conf-available/nextcloud-proxy.conf
RemoteIPHeader X-Forwarded-For
RemoteIPInternalProxy 10.20.30.10
ServerTokens Prod
ServerSignature Off
Die Installation läuft am sichersten über die Befehlszeile, als Benutzer des Webservers (www-data). Lässt du die Passwort-Optionen weg, fragt occ sie interaktiv ab. Dann landen sie weder in der Shell-Historie noch in der Prozessliste.
Im Container (Datenbank-Passwort aus Schritt 4 und ein neues Admin-Passwort eingeben)
Nimm für das Adminkonto keinen Namen wie admin, den Bots als Erstes ausprobieren. Das Passwort sollte lang sein und aus dem Passwortmanager stammen.
So erkennst du, dass es klappt
Am Ende steht Nextcloud was successfully installed. sudo -u www-data php occ status zeigt installed: true und die Version.
9Konfigurieren: Domain, Proxy und Zwischenspeicher
Nextcloud lässt Anfragen nur für bekannte Domains zu und muss wissen, dass davor ein Proxy sitzt, der HTTPS spricht. Setze das mit occ. Der Befehl schreibt in die config.php:
Trage bei trusted_proxies nur Server ein, die du selbst kontrollierst. Wer dort steht, darf die angezeigte Client-Adresse bestimmen. Die Dokumentation warnt ausdrücklich vor falschen Werten, weil Clients sonst ihre Adresse fälschen können.
Redis und APCu als Zwischenspeicher
Für einen einzelnen Server empfiehlt die Dokumentation APCu als lokalen Speicher und Redis für verteilten Speicher und Dateisperren. Wir nutzen für Redis einen Unix-Socket. Der Webserver-Benutzer muss dafür in die Gruppe redis:
Im Container
sed -i 's|^# unixsocket .*|unixsocket /run/redis/redis-server.sock|; s|^# unixsocketperm .*|unixsocketperm 770|' /etc/redis/redis.conf
usermod -a -G redis www-data
systemctl restart redis-server apache2
redis-cli -s /run/redis/redis-server.sock ping antwortet PONG. Nach dem Neustart von Apache fängt Nextcloud ohne Fehlermeldung an, die Übersicht meldet später keinen fehlenden Zwischenspeicher.
10Hintergrundaufgaben per Cron
Nextcloud erledigt regelmäßig Aufräum- und Wartungsaufgaben. Zuverlässig läuft das per Cron, alle fünf Minuten, unter dem Benutzer des Webservers:
crontab -u www-data -l zeigt die Zeile. In den Verwaltungseinstellungen unter Grundeinstellungen steht bei Hintergrundaufgaben Cron und ein aktueller Zeitpunkt der letzten Ausführung.
11HTTPS über den Reverse Proxy
Der Reverse Proxy nimmt Anfragen aus dem Internet an, hält das Zertifikat und reicht sie intern per HTTP an den Container weiter. Im Nginx Proxy Manager legst du einen neuen Proxy Host an:
Einstellung
Wert
Domain Names
cloud.example.org
Scheme / Forward Host / Port
http / 10.20.30.201 / 80
Cache Assets
aus
Websockets Support
an
Block Common Exploits
an (melden Clients Fehler, testweise ausschalten)
Reiter SSL
Neues Zertifikat (Let's Encrypt), Force SSL an, HTTP/2 an
Im Reiter Advanced ergänzt du Werte für große Dateien und lange Übertragungen:
Nutzt du Caddy statt Nginx Proxy Manager, reicht ein Eintrag, das Zertifikat holt Caddy selbst: cloud.example.org { reverse_proxy 10.20.30.201:80 }.
So erkennst du, dass es klappt
https://cloud.example.org zeigt die Anmeldeseite mit gültigem Zertifikat. In den Zugriffsprotokollen im Container (/var/log/apache2/nextcloud-access.log) steht die echte Adresse des Besuchers, nicht die des Proxys.
12Absichern: Zwei-Faktor und Wartung
Melde dich an und öffne Verwaltungseinstellungen → Übersicht. Nextcloud prüft dort Sicherheit und Einrichtung und nennt die nächsten Schritte, zum Beispiel:
Aktiviere die App für zeitbasierte Einmalcodes. Jeder Benutzer richtet den zweiten Faktor danach selbst in den persönlichen Einstellungen unter Sicherheit ein. Als Ersatz gibt es Sicherungscodes. Ein Administrator kann den zweiten Faktor für alle verlangen.
Richte zuerst deinen eigenen zweiten Faktor ein und sichere die Codes, und schalte den Zwang erst danach für alle ein. Sonst sperrst du dich selbst aus. Ein Administrator kann den Faktor eines Benutzers im Notfall mit occ twofactorauth:disable <Benutzer> totp zurücksetzen.
Hinweis
Nextcloud bremst Anmeldeversuche pro Adresse von selbst (Brute-Force-Schutz). Deaktiviere Apps, die du nicht brauchst, und lege für jede Person ein eigenes Konto an.
13Backup und Updates
Sichere den Container samt Datenvolume mit dem Proxmox-Backup-Job (siehe Projekt Proxmox, Schritt 10). Da das Volume mit backup=1 angelegt wurde, ist es dabei. Damit die Datenbank in einem sauberen Zustand im Backup liegt, legst du zusätzlich jede Nacht einen Dump ab, kurz vor dem Job:
/etc/cron.d/nextcloud-dbdump im Container (eine Zeile)
Teste die Wiederherstellung wirklich: Backup des Containers in eine neue ID zurückspielen (pct restore), starten, anmelden und eine Datei öffnen.
Nextcloud aktualisieren
Mache vor jedem Update einen Snapshot des Containers. Nextcloud aktualisierst du über die Weboberfläche (Verwaltungseinstellungen → Übersicht → Updater) oder auf der Befehlszeile. Nimm immer nur eine Hauptversion auf einmal.
Update mit Rückweg
pct snapshot 201 vor-update # am Proxmox-Host
sudo -u www-data php /var/www/nextcloud/updater/updater.phar # im Container
# schlägt etwas fehl: pct rollback 201 vor-update
Das Betriebssystem im Container hält unattended-upgrades aktuell. Zusätzlich lohnt sich ein gelegentliches apt update && apt full-upgrade.
14Endkontrolle
Zum Abschluss hakst du die Punkte ab:
Häufige Stolpersteine
„Zugriff über eine nicht vertrauenswürdige Domain“. Die Domain fehlt bei trusted_domains (Schritt 9).
Endlose Weiterleitungen oder Mischinhalt.overwriteprotocol ist nicht auf https gesetzt, oder der Proxy meldet das Protokoll nicht.
Im Log steht überall die Adresse des Proxys.RemoteIPInternalProxy (Apache) und trusted_proxies (Nextcloud) stimmen nicht mit der Adresse des Proxys überein.
Hochladen großer Dateien bricht ab. Am Reverse Proxy fehlt client_max_body_size oder die Zeitlimits (Schritt 11).
Redis-Fehler nach dem Neustart.www-data ist nicht in der Gruppe redis, oder die Socket-Rechte sind nicht 770.