please login first!

login

Projekt · Cloud

Nextcloud auf Debian in Proxmox einrichten

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

Das brauchst du

  • Einen laufenden Proxmox-Server, am besten nach dem Projekt „Proxmox einrichten, absichern und mit 2FA schützen“.
  • Etwa 4 GB freien Arbeitsspeicher und 2 CPU-Kerne für den Container, dazu Platz für die Daten.
  • Eine (Sub-)Domain wie cloud.example.org, deren DNS-Eintrag auf deinen Server zeigt.
  • Einen Reverse Proxy, der HTTPS und das Zertifikat übernimmt (hier: Nginx Proxy Manager, Alternative: Caddy).

Das Ergebnis

  • Nextcloud auf Debian 13 in einem eigenen Container.
  • Apache, PHP 8.4, MariaDB 11.8 und Redis, alles aus den Debian-Paketquellen.
  • Daten auf einem eigenen Volume, getrennt vom System.
  • HTTPS über den Reverse Proxy, Hintergrundaufgaben per Cron.
  • Zwei-Faktor-Login und Backups, die den Container samt Daten enthalten.

So hängt alles zusammen

Browser und AppsZugriff über
https://cloud.example.org
Reverse ProxyZertifikat und HTTPS,
reicht intern per HTTP weiter
Nextcloud-ContainerDebian 13 · Apache
PHP 8.4 · MariaDB · Redis
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

FrageEntscheidungBegründung
BetriebssystemDebian 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 VMUnprivilegierter LXC-ContainerSparsam, schnell gesichert und in Sekunden gestartet. Eine VM lohnt sich, wenn du einen eigenen Kernel oder stärkere Trennung brauchst.
AufteilungAlles in einem ContainerApache, 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.
InstallationswegOffizielles Archiv (tar.bz2)Volle Kontrolle ohne Zusatzschicht, Updates über den eingebauten Updater. Alternativen sind Nextcloud All-in-One (Docker) oder Snap.
WebserverApache mit mod_phpEinfach und für kleine Installationen ausreichend. Die Nextcloud-Dokumentation nennt php-fpm als Alternative für höhere Last.
HTTPSAm Reverse ProxyZertifikate 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
Am Proxmox-Host
pct create 201 local:vztmpl/debian-13-standard_13.6-1_amd64.tar.zst \
  --hostname nextcloud --unprivileged 1 --features nesting=1 \
  --cores 2 --memory 4096 --swap 512 \
  --rootfs local-lvm:16 \
  --mp0 local-lvm:100,mp=/srv/nextcloud-data,backup=1 \
  --net0 name=eth0,bridge=vmbr1,firewall=1,ip=10.20.30.201/24,gw=10.20.30.1 \
  --nameserver 9.9.9.9 --onboot 1 --ostype debian --tags nextcloud
pct start 201
pct enter 201

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.

Im Container
apt update && apt full-upgrade -y
apt install -y sudo curl ca-certificates gnupg cron unattended-upgrades
timedatectl set-timezone Europe/Berlin

unattended-upgrades installiert Sicherheitsupdates für Debian-Pakete automatisch. Nextcloud selbst aktualisierst du getrennt (Schritt 13).

3Pakete installieren

Alles, was Nextcloud braucht, kommt aus den Debian-Paketquellen: Webserver, PHP samt Modulen, Datenbank und Redis als Zwischenspeicher.

Im Container
apt install -y apache2 libapache2-mod-php mariadb-server redis-server \
  php-curl php-gd php-mbstring php-xml php-zip php-mysql php-intl \
  php-bcmath php-gmp php-apcu php-redis php-imagick bzip2 unzip

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:

/etc/php/8.4/apache2/conf.d/90-nextcloud.ini
memory_limit = 512M
date.timezone = Europe/Berlin
opcache.enable = 1
opcache.save_comments = 1
opcache.revalidate_freq = 60

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?).

Im Container
cd /tmp
curl -fLO https://download.nextcloud.com/server/releases/latest.tar.bz2
curl -fLO https://download.nextcloud.com/server/releases/latest.tar.bz2.sha256
curl -fLO https://download.nextcloud.com/server/releases/latest.tar.bz2.asc
curl -fL https://nextcloud.com/nextcloud.asc | gpg --import

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:

Fingerabdruck des Nextcloud-Signaturschlüssels
2880 6A87 8AE4 23A2 8372  792E D758 99B9 A724 937A
Im Container
sha256sum -c latest.tar.bz2.sha256 --ignore-missing
gpg --verify latest.tar.bz2.asc latest.tar.bz2
So erkennst du, dass es klappt

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:

Im Container
tar -xjf latest.tar.bz2 -C /var/www
chown -R www-data:www-data /var/www/nextcloud
chown www-data:www-data /srv/nextcloud-data
chmod 750 /srv/nextcloud-data
rm /tmp/latest.tar.bz2*
Hinweis

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
Im Container
a2enconf nextcloud-proxy
a2ensite nextcloud
apachectl configtest
systemctl reload apache2
So erkennst du, dass es klappt

apachectl configtest meldet Syntax OK.

8Nextcloud installieren

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)
cd /var/www/nextcloud
sudo -u www-data php occ maintenance:install \
  --database mysql --database-name nextcloud --database-user nextcloud \
  --admin-user dein-admin-name \
  --data-dir /srv/nextcloud-data
Hinweis

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:

Im Container
cd /var/www/nextcloud
sudo -u www-data php occ config:system:set trusted_domains 1 --value=cloud.example.org
sudo -u www-data php occ config:system:set overwrite.cli.url --value=https://cloud.example.org
sudo -u www-data php occ config:system:set overwriteprotocol --value=https
sudo -u www-data php occ config:system:set trusted_proxies 0 --value=10.20.30.10
sudo -u www-data php occ config:system:set forwarded_for_headers 0 --value=HTTP_X_FORWARDED_FOR
sudo -u www-data php occ config:system:set default_phone_region --value=DE
sudo -u www-data php occ config:system:set maintenance_window_start --type=integer --value=1
Achtung

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
Im Container
cd /var/www/nextcloud
sudo -u www-data php occ config:system:set memcache.local --value='\OC\Memcache\APCu'
sudo -u www-data php occ config:system:set memcache.distributed --value='\OC\Memcache\Redis'
sudo -u www-data php occ config:system:set memcache.locking --value='\OC\Memcache\Redis'
sudo -u www-data php occ config:system:set redis host --value=/run/redis/redis-server.sock
sudo -u www-data php occ config:system:set redis port --value=0 --type=integer
So erkennst du, dass es klappt

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:

Im Container
echo '*/5 * * * * php -f /var/www/nextcloud/cron.php' | crontab -u www-data -
sudo -u www-data php /var/www/nextcloud/occ background:cron
So erkennst du, dass es klappt

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:

EinstellungWert
Domain Namescloud.example.org
Scheme / Forward Host / Porthttp / 10.20.30.201 / 80
Cache Assetsaus
Websockets Supportan
Block Common Exploitsan (melden Clients Fehler, testweise ausschalten)
Reiter SSLNeues 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:

Nginx Proxy Manager: Advanced
client_max_body_size 10G;
proxy_request_buffering off;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
Hinweis

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:

Im Container (falls die Übersicht es verlangt)
cd /var/www/nextcloud
sudo -u www-data php occ db:add-missing-indices
sudo -u www-data php occ maintenance:repair --include-expensive

Zwei-Faktor-Login

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.

Im Container
sudo -u www-data php occ app:enable twofactor_totp
sudo -u www-data php occ twofactorauth:enforce --on
Achtung

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)
30 1 * * * root umask 077; mkdir -p /var/backups/nextcloud; mariadb-dump --single-transaction nextcloud | gzip > /var/backups/nextcloud/nextcloud-db.sql.gz
So erkennst du, dass es klappt

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

Weiterlesen