SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

Nextcloud AIO op een VPS: installatie en reset

Nextcloud All-in-One op je VPS in een EU-datacenter: installeren, waarom ufw poort 8080 niet dichtzet, de Borg-back-up met zijn sleutel en een veilige reset.

Wat Nextcloud AIO op een VPS precies doet

Nextcloud AIO op een VPS start je met één docker run-commando. Dat commando start de mastercontainer, en die zet daarna zelf alle andere containers op: Nextcloud, de database, de webserver en de extra's die je aanvinkt. AIO staat voor All-in-One. Nextcloud GmbH onderhoudt het image zelf en beschrijft het op de installatiepagina als een Docker-image "that is easy to install and maintain".

Veel lezers in Nederland en België kiezen een VPS in een EU-datacenter omdat ze willen weten waar hun bestanden staan en wie erbij kan. Met AIO beheer jij de server en de sleutels van de back-up. Dat geldt voor elke Nextcloud-installatie op je eigen server. AIO maakt vooral het onderhoud eenvoudiger. Deze gids behandelt de installatie en daarna de punten waar het in de praktijk misgaat: poort 8080, de passphrase, de back-up en een reset.

AIO of een zelfgebouwde Docker Compose-stack?

AIO is een beheerde stack. De mastercontainer bepaalt welke containers er draaien en hoe ze met elkaar verbonden zijn. Updates en back-ups start je met een knop in de AIO-interface. Daar staat tegenover dat je controle inlevert. Je schrijft het compose-bestand niet zelf, de namen van de container en het volume liggen vast, en je past instellingen aan via de variabelen die AIO aanbiedt. Wil je elke container zelf kiezen en zelf bijwerken, volg dan onze gids voor Nextcloud met Docker Compose, TLS en back-ups. Die gids behandelt compose en TLS, dus dat herhalen we hier niet. Twijfel je nog over de licentie, lees dan eerst het verschil tussen Nextcloud Hub en Nextcloud Enterprise.

Wat je nodig hebt voordat je begint

  • Een KVM-VPS. De README van AIO zegt dat VPS'en op KVM of zonder virtualisatie het best werken, omdat Docker daar het best draait.
  • Een processor met x86_64/amd64 of aarch64/arm64. Dat zijn de architecturen die de README noemt. Meer over die keuze staat in ARM-VPS of x86-VPS.
  • Docker, geïnstalleerd volgens de officiële documentatie van Docker. De README zegt letterlijk: "Snap-based Docker installations are not supported." Heb je nog geen Docker, volg dan Docker installeren op een VPS.
  • Een domeinnaam met een DNS-record (een A-record, en eventueel een AAAA-record) dat naar het IP-adres van je VPS wijst.

Controleer eerst hoe Docker op de server staat:

snap list 2>/dev/null | grep -i docker
sudo docker version

Geeft de eerste regel uitvoer, dan is Docker als Snap geïnstalleerd. Verwijder die versie met sudo snap remove docker en installeer Docker opnieuw vanuit de repository van Docker. sudo docker version hoort twee blokken te tonen, Client en Server. Zie je alleen Client en daarna Cannot connect to the Docker daemon, dan draait de Docker-service niet.

De mastercontainer starten

Dit is het commando uit de README voor Linux, voor een server zonder bestaande webserver of reverse proxy:

sudo docker run \
--init \
--sig-proxy=false \
--name nextcloud-aio-mastercontainer \
--restart always \
--publish 80:80 \
--publish 8080:8080 \
--publish 8443:8443 \
--volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config \
--volume /var/run/docker.sock:/var/run/docker.sock:ro \
ghcr.io/nextcloud-releases/all-in-one:latest

Wat de belangrijke regels doen:

  • --name nextcloud-aio-mastercontainer mag je niet veranderen. De updates van de mastercontainer zoeken de container op deze naam.
  • --volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config mag je ook niet veranderen. De ingebouwde back-up hangt af van deze volumenaam.
  • /var/run/docker.sock wordt alleen-lezen gekoppeld. Via die socket maakt en beheert de mastercontainer de andere containers op je host.
  • --sig-proxy=false zorgt ervoor dat je met Ctrl+C uit de uitvoer in je terminal stapt zonder de container te stoppen. --restart always start de container opnieuw na een reboot.

Het commando blijft aan je terminal hangen en toont de log. Druk op Ctrl+C en controleer daarna of de container draait:

sudo docker ps

In de lijst hoort nextcloud-aio-mastercontainer te staan met een status die begint met Up. Staat hij er niet, bekijk dan de laatste logregels met sudo docker logs nextcloud-aio-mastercontainer.

De AIO-interface openen op poort 8080

Open in je browser https://<IP-adres van je VPS>:8080. Gebruik het IP-adres en niet je domeinnaam. De README geeft de reden: HSTS (HTTP Strict Transport Security) kan je later de toegang blokkeren. HSTS betekent dat je browser onthoudt dat een domein alleen met een geldig certificaat bereikbaar mag zijn. Poort 8080 gebruikt een zelfondertekend certificaat, dus je browser toont eerst een waarschuwing. Die waarschuwing moet je accepteren.

Er is een tweede route via poort 8443. Daar krijgt de interface een geldig certificaat. Daarvoor moet je domein al naar de server wijzen en moeten poort 80 en 8443 van buiten bereikbaar zijn. Open dan https://jouwdomein.nl:8443.

De interface toont een passphrase, een lange wachtwoordzin. Bewaar die meteen in je wachtwoordmanager. Daarna vul je je domein in. AIO controleert het domein voordat het verder gaat, dus zorg dat het DNS-record al klopt en dat 443/TCP open staat. Vervolgens kies je de optionele containers, zoals Nextcloud Office, Talk, ClamAV, Full-text Search en Imaginary. Kies je voor Nextcloud Office, lees dan eerst de vergelijking tussen OnlyOffice en Collabora. Daarna start je de containers vanuit de interface.

Welke poorten moet je openen voor Nextcloud AIO?

Volgens de README zijn alleen deze poorten verplicht open in je firewall, als je de AIO-interface intern via poort 8080 opent:

  • 443/TCP voor de Apache-container. Dit is de poort waarop Nextcloud zelf bereikbaar is.
  • 443/UDP, alleen als je HTTP/3 wilt gebruiken.
  • 3478/TCP en 3478/UDP voor de Talk-container. Dit is de TURN-server (Traversal Using Relays around NAT), die gesprekken doorgeeft als twee deelnemers elkaar niet direct bereiken.

SSH (22/TCP) staat niet in die lijst. Beheer je de server via SSH, dan houd je die poort zelf open.

Waarom ufw poort 8080 niet dichtzet

Hier gaat het vaak mis. De documentatie van Docker zegt: "Publishing container ports is insecure by default." Een gepubliceerde poort is bereikbaar vanaf de hele wereld, niet alleen vanaf de host. Docker en ufw zijn volgens dezelfde documentatie niet met elkaar te combineren. Docker leidt binnenkomende pakketten al in de nat-tabel om, nog voordat ze de INPUT-regels bereiken. Daar staan juist de regels van ufw. Een regel als sudo ufw deny 8080 doet dus niets voor deze container. Dat geldt ook voor poort 80 en 8443. Hoe dat precies werkt, lees je in waarom Docker-poorten om ufw heen gaan.

Docker zegt ook dat een poort die je aan 127.0.0.1 koppelt, alleen vanaf de host bereikbaar is. Het AIO-commando publiceert de poorten op alle adressen, en de README geeft geen variant waarin dat anders is. Daarom passen we het commando hier niet aan. Sluit poort 8080 en 8443 in plaats daarvan in de netwerkfirewall van je provider, in het klantpaneel. Die firewall filtert de pakketten voordat ze de VPS bereiken, dus Docker kan er niet omheen. Kan je provider-firewall regels per bron-IP maken, sta 8080 dan alleen toe vanaf je eigen IP-adres.

Test het daarna vanaf je eigen computer, niet vanaf de VPS:

nc -zv -w 5 203.0.113.10 8080

Vervang 203.0.113.10 door het IP-adres van je VPS. Het woord succeeded betekent dat de poort nog open staat. timed out betekent dat de firewall de poort blokkeert. Verandert je eigen IP-adres vaak, gebruik dan een SSH-tunnel naar de interface:

ssh -L 8080:127.0.0.1:8080 gebruiker@203.0.113.10

Laat die sessie open en ga in je browser naar https://localhost:8080.

Welke versie draai je, en waarom :latest?

Op 15 november 2026 is v15.0.2 de nieuwste stabiele versie van AIO. Die verscheen op 3 november en bevat Nextcloud 35.0.2. Er is ook een bètaversie, v15.1.0 van 13 november, met Nextcloud 35.0.3. Nextcloud zelf bracht 35.0.3 uit op 12 november. De stabiele AIO-versie loopt dus iets achter op Nextcloud. De README zegt dat een update ongeveer twee weken nodig kan hebben om het latest-kanaal te bereiken.

De README beschrijft twee kanalen: latest en beta. Volgens het releasebeleid verschijnt er ongeveer elke twee weken een nieuwe bèta, die ongeveer zeven dagen wordt getest. Komen er geen problemen, dan wordt die bèta een definitieve release. Een bèta met problemen krijgt een opvolger met een hoger versienummer. Over andere tags, zoals een vast versienummer, zegt het releasebeleid niets, in geen enkele richting. Daarom gebruikt deze gids :latest uit het officiële commando en geen vastgepinde versie.

Wil je naar het bètakanaal, dan stop en verwijder je de mastercontainer. Je verliest daarbij geen data. Daarna start je hem opnieuw met hetzelfde commando, waarbij je alleen de laatste regel verandert in ghcr.io/nextcloud-releases/all-in-one:beta. Volgens de README moet je in zeldzame gevallen dat image eerst met docker pull ophalen.

Nextcloud 35 verscheen op 16 september 2026 en krijgt ondersteuning tot september 2027. Volgens het releaseschema verschijnt er elke vier maanden een nieuwe hoofdversie.

Waarom je niet kunt inloggen op de AIO-interface

Je passphrase klopt, maar de loginpagina weigert. Dat is meestal geen fout. Zolang Nextcloud draait, blokkeert AIO de directe login, dus het invullen van de passphrase op de loginpagina. Na een geslaagde login gaat die blokkade weer aan. Dat gebeurt ook na 5 minuten, of na 5 verkeerde pogingen.

De omweg is de indirecte login. Log in op Nextcloud als beheerder en open https://jouwdomein.nl/settings/admin/overview. Klik op de knop bovenaan de pagina. Die opent de AIO-loginpagina, en voor jouw browsersessie is de directe login dan vrijgegeven. Vul daar je passphrase in. Als de containers gestopt zijn, is de directe login nooit geblokkeerd.

Passphrase kwijt: zo lees je hem terug

De README heeft geen aparte sectie voor een verloren passphrase. De beheerders van het project geven in de GitHub-discussies van het project (discussie #1786, uit januari 2023) dit commando:

sudo docker exec nextcloud-aio-mastercontainer grep password /mnt/docker-aio-config/data/configuration.json

Het commando zoekt in het configuratiebestand van de mastercontainer naar de regel met password. In die regel staat je passphrase. Dit is een antwoord uit de discussies en geen tekst uit de README, dus controleer de README voordat je erop bouwt. Het werkt alleen zolang de mastercontainer en het volume nextcloud_aio_mastercontainer nog bestaan. Is het volume weg, dan is ook dit bestand weg.

De ingebouwde Borg-back-up van Nextcloud AIO

AIO heeft een eigen back-up op basis van BorgBackup. De back-ups zijn incrementeel, gecomprimeerd en versleuteld. In de AIO-interface kies je waar ze komen te staan. Dat kan een lokale map zijn, bijvoorbeeld een extra schijf die op /mnt/backup is gekoppeld. Het kan ook een externe Borg-repository zijn. Dan zet je de publieke SSH-sleutel die AIO aanmaakt op die externe server.

De back-ups worden versleuteld met een sleutel die de interface aan je toont. De README waarschuwt dat je zonder deze sleutel niet kunt herstellen. Je maakt en herstelt back-ups met de knoppen Create Backup en Restore selected backup. Dagelijkse back-ups kun je aanzetten nadat de eerste back-up klaar is.

Volgens de README heb je alleen het archief en het wachtwoord nodig om de hele instantie op een nieuwe AIO-installatie terug te zetten. Op de nieuwe server kies je dan "Restore former AIO instance from backup". Je geeft het pad naar de back-up op en het versleutelingswachtwoord van de oude back-up. De nieuwe installatie maakt intussen haar eigen passphrase aan. In de praktijk heb je dus twee geheimen: de passphrase voor de interface en de sleutel van de back-up. Bewaar ze allebei, op een andere plek dan de VPS.

Een back-up op dezelfde VPS beschermt je niet als die VPS verdwijnt. Kies daarom een externe Borg-repository, of kopieer de lokale map naar een andere server. Twijfel je tussen Borg en een andere tool voor de rest van je server, lees dan restic of BorgBackup. Ga je naar een andere provider, dan helpt een server verhuizen naar een nieuwe VPS bij de rest van de verhuizing.

Hoeveel RAM hebben de optionele containers nodig?

Een officieel minimum per container, of per set containers zoals Collabora, Talk, ClamAV en Full-text Search, staat niet in de README. Er staan wel twee standaardwaarden in. AIO geeft elk PHP-proces standaard maximaal 512 MB RAM, en dat kun je aanpassen. Full-text Search start Java standaard met -Xms512M -Xmx512M, en de README zegt zelf dat dit op sommige systemen niet genoeg kan zijn. De algemene systeemeisen van Nextcloud noemen minimaal 128 MB RAM per proces en raden minimaal 512 MB per proces aan. Die pagina gaat over Nextcloud-servers in het algemeen, niet over AIO.

Meet daarom zelf. Begin zonder optionele containers, zet ze één voor één aan en kijk na elke stap:

free -h
sudo docker stats --no-stream

free -h toont in de kolom available hoeveel geheugen er nog vrij is. docker stats toont per container het gebruik in de kolom MEM USAGE. Zakt available bijna naar nul, dan is de VPS te klein voor die set containers.

Achter een reverse proxy, of via Portainer

Draai je al een webserver of reverse proxy op de VPS, gebruik dan niet het commando hierboven. AIO heeft daarvoor een aparte handleiding, reverse-proxy.md in de repository op GitHub. Twee variabelen uit die handleiding kom je meteen tegen. APACHE_PORT is de poort op de host waar je reverse proxy naartoe moet wijzen. APACHE_IP_BINDING beperkt welke IP-adressen die poort bereiken. Volg die handleiding volledig, want het startcommando verandert ermee.

Gebruik je Portainer, dan zegt de README dat de eenvoudigste manier de stacks-functie van Portainer is, met het bestand compose.yaml uit de repository. Dat bestand gebruikt hetzelfde image, dezelfde containernaam, dezelfde volumes en dezelfde poorten als het docker run-commando.

Nextcloud AIO volledig resetten na een mislukte installatie

De README beschrijft een reset voor een eerste installatie die misging. De waarschuwing staat er duidelijk bij: draait je instantie al en staat er data op, volg deze stappen dan niet, want ze verwijderen alle data van je AIO-instantie.

Let ook op twee commando's. docker container prune verwijdert alle gestopte containers op de host. docker volume prune --filter all=1 verwijdert alle volumes die geen container gebruikt, ook die van andere projecten. Kijk dus eerst wat er op de server staat:

sudo docker ps -a
sudo docker volume ls

Stop daarna eerst alle AIO-containers via de AIO-interface. Voer dan deze stappen uit:

sudo docker stop nextcloud-aio-mastercontainer
sudo docker stop nextcloud-aio-domaincheck
sudo docker container prune
sudo docker network rm nextcloud-aio
sudo docker volume prune --filter all=1

Het tweede commando is alleen nodig als de domaincheck-container nog draait. Geeft hij No such container, dan is hij al weg. Heb je een eigen map ingesteld met NEXTCLOUD_DATADIR, verwijder die map dan ook. Controleer daarna dat er geen AIO-volumes meer over zijn:

sudo docker volume ls --filter name=nextcloud_aio

Deze lijst hoort leeg te zijn, op de kopregel na. Wil je ook de images opruimen, dan kan dat met sudo docker image prune -a. Dat raakt opnieuw alle ongebruikte images op de host. Begin daarna opnieuw met het docker run-commando uit deze gids. Vergelijk de stappen vóór je begint met de sectie "How to properly reset the instance?" in de actuele README, omdat die kan veranderen.

FAQ

Waarom kan ik niet inloggen op de AIO-interface terwijl mijn passphrase klopt?

Zolang Nextcloud draait, blokkeert AIO de directe login met de passphrase. De blokkade komt ook terug na een geslaagde login, na 5 minuten of na 5 verkeerde pogingen. Log als beheerder in op Nextcloud, open /settings/admin/overview en klik op de knop bovenaan. Die opent de AIO-loginpagina met de directe login vrijgegeven voor jouw browsersessie.

Waarom is poort 8080 nog bereikbaar terwijl ufw hem blokkeert?

Docker leidt pakketten voor gepubliceerde poorten al in de nat-tabel om, voordat ze bij de INPUT-regels van ufw komen. Een ufw-regel voor 8080 heeft daardoor geen effect op de AIO-interface. Sluit 8080 en 8443 in de netwerkfirewall van je provider en test vanaf je eigen computer met nc -zv -w 5 <IP> 8080.

Kan ik mijn Nextcloud AIO terugzetten met alleen de passphrase?

Nee. Voor een herstel heb je het Borg-archief nodig en de versleutelingssleutel die de AIO-interface bij de back-up toont. De README zegt dat je zonder die sleutel niet kunt herstellen. De passphrase opent alleen de interface, en een nieuwe installatie maakt een nieuwe passphrase aan.

Draait Nextcloud AIO ook in Proxmox, LXC of een VM?

De README raadt VPS'en op KVM of zonder virtualisatie aan, omdat Docker daar het best werkt. In een LXC-container moet je FUSE aanzetten in de instellingen van die container. Op een gewone KVM-VPS hoef je niets extra's te doen.

Was dit artikel nuttig?