Cloudron installeren op een Ubuntu VPS: stappenplan
Installeer Cloudron op een verse Ubuntu VPS met deze handleiding. Leer hoe u wildcard DNS configureert, het script uitvoert en back-ups instelt voor 2 tot 10 applicaties.
Cloudron installeren op een VPS: de korte versie
Om Cloudron op een VPS te installeren heeft u een verse Ubuntu-server nodig, minimaal 2 GB RAM en een domein waarvan u de DNS-records kunt bewerken. De installatie zelf bestaat uit drie commando's en één herstart. Vrijwel alles wat misgaat, gebeurt vóór die stap (verkeerde basis-image, verkeerd virtualisatietype) of erna (DNS, e-mail, back-ups).
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupCloudron installeert, updatet, back-upt en verstrekt TLS-certificaten (transport layer security) voor zelfgehoste applicaties. Elke app draait in Docker, nginx fungeert als proxy voor alle apps en elke app krijgt een eigen subdomein van uw domein. Dat laatste detail is de reden waarom het DNS-werk hier als eerste aan bod komt.
Waarom Cloudron strikte eisen stelt aan het basis-OS
Het installatiescript controleert de server voordat er iets wordt geïnstalleerd. Als een controle faalt, moet u een nieuwe server bestellen. Lees deze eisen door voordat u een image kiest. De controles in dit gedeelte zijn gebaseerd op 13 oktober 2026; de huidige installatiedocumentatie vereist een schone Ubuntu 26.04-server.
- Alleen Ubuntu, en slechts drie releases. Elke andere versie resulteert in
Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 wordt geweigerd en de installatiedocumentatie vereist nu een schone Ubuntu 26.04-server. Debian, Rocky en Alpine worden niet ondersteund. Ubuntu 24.04 vereist Cloudron 8 of nieuwer; het script controleert dit automatisch voor u. - Alleen 64-bit Intel of AMD:
Error: Cloudron only supports amd64/x86_64. Een ARM VPS wordt niet ondersteund. - Alleen volledige hardware-virtualisatie. Op een container-gebaseerde VPS stopt het script met
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization, omdat het de container detecteert metsystemd-detect-virt --container. KVM is geschikt. OpenVZ en LXC niet. - Het root-bestandssysteem moet
ext4ofxfszijn. Bij elk ander bestandssysteem krijgt uError: Cloudron requires '/' to be ext4 or xfs; dit is de reden waarom btrfs- en zfs-images falen. - Minimaal 941 MB RAM, gemeten met
free -m, en 18 GB op/, gemeten als de grootte van het root-bestandssysteem. De foutmelding vraagt om 20 GB, maar de controle zelf accepteert een root-bestandssysteem van 19 GB. - Een volledig schone server. Als
nginx,dockerofnodeal zijn geïnstalleerd, weigert het script de installatie metError: Some packages like nginx/docker/nodejs are already installed..
De laatste controle leidt vaak tot discussie, dus hier is de reden daarvoor. Cloudron installeert specifieke versies van Docker, nginx, Node.js en MySQL, schrijft de nginx-configuratie voor elke gehoste app en beheert zelf de iptables-firewallregels. Een Docker-versie die u gisteren handmatig heeft geïnstalleerd, is de verkeerde versie. Daarom stopt het script zonder wijzigingen aan te brengen en krijgt u het verzoek om met een schone Ubuntu-installatie te beginnen. Cloudron beheert de volledige machine; gebruik daarom een toegewezen VPS.
Eén controle wordt vaak over het hoofd gezien. Op een oudere CPU zonder AVX (advanced vector extensions) toont het script CPU has no AVX support. MongoDB will be disabled, waardoor elke app die MongoDB vereist oninstalleerbaar wordt. Controleer de CPU voordat u verdergaat met grep -m1 -o avx /proc/cpuinfo; dit commando geeft avx weer op een geschikte host en niets op een verouderde host.
Hoeveel RAM heeft Cloudron nodig?
De installatiecontrole van 13 oktober 2026 weigerde te draaien onder 941 MB, met Error: Cloudron requires atleast 1GB physical memory; de huidige documentatie vereist 2 GB RAM en 20 GB schijfruimte. Beide getallen vormen de ondergrens voor het platform zelf, niet voor het platform inclusief uw applicaties. Cloudron draait Docker, nginx, zijn eigen box-service en de mail-stack, en voorziet in gedeelde databaseservices naarmate apps worden uitgerold. Voer docker ps uit op een verse installatie en tel de processen.
Geheugenlimieten voor apps komen boven op deze basis. Elk app-pakket wordt geleverd met een lage standaardlimiet; u verhoogt deze met de schuifregelaar in de weergave Resources van de app. Wanneer een app zijn limiet overschrijdt, herstart deze en ontvangt u een OOM-melding (out of memory). Een server die constant één app herstart, heeft daarom meestal een limietprobleem in plaats van een bug.
Dit is de dimensionering die ik zou aanhouden. Dit zijn aanbevelingen voor een server die u volgende maand niet opnieuw hoeft op te bouwen. Het zijn geen gemeten benchmarkresultaten.
De gegevens achter deze grafiek
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]Twee apps draaien comfortabel op 4 GB RAM en 60 GB schijfruimte. Voor ongeveer tien apps is 16 GB RAM en 240 GB schijfruimte gewenst, omdat de basis van het platform niet krimpt en elke app een Docker-image, een database en eigen data toevoegt. Schijfruimte raakt sneller vol dan men verwacht: images, app-data en lokale back-ups delen één volume totdat u back-ups naar een externe locatie verplaatst.
Cloudron geeft elke app onbeperkte swap, dus de geheugenlimiet die u instelt is alleen van toepassing op RAM. Op een VPS-image zonder swap-bestand geeft swapon --show niets weer, en geheugendruk leidt direct tot OOM-herstarts in plaats van een trage applicatie. Het toevoegen van 2 GB swap is een goedkope verzekering, hoewel het geen vervanging is voor fysiek geheugen. Het prijsverschil tussen VPS-abonnementen is klein in vergelijking met de uren die u kwijt bent aan het afstellen van limieten; bekijk daarom wat een VPS daadwerkelijk kost en kies de eerstvolgende grotere configuratie.
DNS: het wildcard-record dat app-subdomeinen laat werken
Cloudron plaatst het dashboard op my.example.com en elke app op een eigen subdomein; DNS is daarom een vereiste en geen latere stap. Wijs deze records naar het publieke IP-adres van de server voordat u het dashboard voor de eerste keer opent:
my.example.comals A-record. Dit is het dashboard.*.example.comals A-record. Dit record zorgt ervoor dat app-subdomeinen werken, zodatwiki.example.comengit.example.comdirect resolven zodra u die apps installeert.example.comals A-record, alleen als u een app op het hoofddomein wilt draaien.
Een wildcard-record heeft een lagere prioriteit dan een expliciet record, dus een bestaand www.example.com dat naar een andere locatie wijst, blijft gewoon werken.
Tijdens de installatie kiest u hoe Cloudron vanaf dat moment DNS beheert:
- Een API-provider. Cloudron slaat een token op voor Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS en anderen (in totaal 22 API DNS-integraties, exclusief Wildcard, Handmatig en No-op), en schrijft vervolgens zelf elk record, inclusief mailrecords.
- Wildcard. U voegt het
*-record handmatig toe en Cloudron schrijft niets. - Handmatig. Cloudron toont u elk record en wacht tot u het heeft toegevoegd, vóór elke app-installatie.
Een wildcard DNS-record is geen wildcard-certificaat. De standaard certificaatprovider is Let's Encrypt Prod - Wildcard, die eigenaarschap via DNS bewijst; dit werkt daarom alleen met een API-provider. Bij de Wildcard- of Handmatige-backends geeft Let's Encrypt individuele certificaten uit die via HTTP worden gevalideerd. Dit vereist inkomende poort 80 voor uitgifte en vernieuwing. U kunt de Let's Encrypt-integratie uitschakelen en een eigen wildcard-certificaat uploaden, zodat poort 80 geen permanente vereiste is voor certificaatvalidatie. Als uw registrar of DNS-host op de API-lijst staat, gebruik deze dan: mailrecords en certificaten zijn dan niet langer uw zorg.
Controleer dit voordat u verdergaat. dig +short my.example.com en dig +short anything.example.com zouden beide het IP-adres van uw server moeten tonen. Als de wildcard-query bij de Wildcard-backend niets teruggeeft, zullen apps later falen terwijl het dashboard prima werkt.
Als het domein achter Cloudflare staat, stel de records dan in op DNS only. De proxy stuurt alleen HTTP en HTTPS door, waardoor de mailpoorten niet meer werken. Voor geproxiede web-apps ondersteunt de Network-weergave van Cloudron het vertrouwen van de gepubliceerde IP-reeksen van Cloudflare, zodat het IP-adres van de bezoeker uit de doorgestuurde headers kan worden herleid.
Het installatiescript uitvoeren
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupVoer het script uit als root of via sudo, omdat de eerste melding die het anders toont This script should be run as root. is. De installatie duurt enkele minuten en verloopt op de achtergrond, aangezien apt-output en Docker-pulls naar een logbestand worden geschreven. Monitor het proces vanuit een tweede SSH-sessie:
tail -f /var/log/cloudron-setup.logTijdens de installatiecontrole op 13 oktober 2026 werd After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. getoond, gevolgd door het adres van de server, waarna de vraag The server has to be rebooted to apply all the settings. Reboot now ? [Y/n] verscheen. Beantwoord deze met yes. Dat installatieprogramma bood ook een --skip-reboot-vlag om de herstart uit te stellen.
Eerste opstart: domein, DNS-backend en het beheerdersaccount
Open https://<server-ip> en accepteer de waarschuwing van de browser. Het certificaat is zelfondertekend omdat Cloudron uw domein nog niet kent; er is dus geen mogelijkheid om een certificaatautoriteit om een certificaat te vragen. Klik in Chrome op Advanced en vervolgens op Proceed to <ip> (unsafe). Klik in Firefox op Advanced en vervolgens op Accept the Risk and Continue.
Het eerste scherm vraagt om uw domein. Voer example.com in; het dashboard wordt vervolgens ingesteld op my.example.com. U kunt ook een subdomein gebruiken, zoals cloudron.example.com, waarna het dashboard bereikbaar is via my.cloudron.example.com. Kies de DNS-backend, plak de API-token indien u deze heeft, en maak het beheerdersaccount aan met een e-mailadres dat u daadwerkelijk controleert: wachtwoordherstel en platformmeldingen worden naar dit adres verzonden.
Wanneer u de instellingen opslaat, vraagt Cloudron certificaten aan en verplaatst het dashboard naar https://my.example.com. De URL met het IP-adres werkt vanaf dat moment niet meer, dus sla de nieuwe URL op in uw bladwijzers.
Certificaten: wat wordt vernieuwd en wanneer dit stopt
De vernieuwing van certificaten verloopt automatisch en volgt de ACME Renewal Information (ARI), het schema dat door de certificaatautoriteit wordt gepubliceerd. In de praktijk vindt de vernieuwing ongeveer een maand voor de verloopdatum plaats. Een mislukte vernieuwing stuurt een e-mail naar het beheerdersaccount en een verlopen certificaat valt terug op het ingebouwde, zelfondertekende certificaat. Die terugval is de werkelijke oorzaak van een browserwaarschuwing op een site die gisteren nog werkte.
Twee oorzaken verklaren het merendeel van deze problemen. HTTP-validatie vereist inkomend verkeer op poort 80. Het sluiten van poort 80 omdat "alles toch al HTTPS is", blokkeert de vernieuwing voor applicaties die Let's Encrypt HTTP-validatie gebruiken op een Wildcard- of handmatige DNS-backend. DNS-validatie vereist een API-token dat nog steeds schrijfrechten heeft; het roteren of beperken van dit token zorgt ervoor dat de vernieuwing stilletjes faalt totdat de waarschuwingsmail arriveert.
Het overzicht met domeinen bevat een Renew All-knop om de poging direct af te dwingen, evenals een Let's Encrypt Staging-provider voor testdoeleinden. Staging-certificaten worden bewust niet vertrouwd door browsers, en dat is precies de bedoeling: testen voorkomt dat de limieten voor productie worden verbruikt. Staging heeft eigen limieten, waaronder 200 autorisatiefouten per identifier per account per uur.
Moet u de ingebouwde mailserver gebruiken?
Cloudron wordt geleverd met een volledige mailstack inclusief IMAP-mailboxen, submission, sieve-filters en DKIM (domainkeys identified mail) ondertekening. U schakelt dit per domein in onder Email in het dashboard. Het afleveren van e-mail is het lastige gedeelte, en de moeilijkheid hiervan ligt niet bij Cloudron.
- Uitgaande poort 25 wordt door de meeste VPS-providers geblokkeerd om spam tegen te gaan. Sommige providers deblokkeren deze na een supportticket. Test dit vanaf de server met
nc -zv aspmx.l.google.com 25(installeernetcat-openbsdals het commando ontbreekt). Open poorten rapporterensucceeded, terwijl een geblokkeerde poort blijft hangen tot de time-out wordt bereikt. - Het PTR-record (reverse DNS) wordt ingesteld door uw VPS-provider, niet door uw DNS-host, en dit moet overeenkomen met de mail-hostname wanneer u rechtstreeks vanaf de server verstuurt. Een smart host heft die PTR-vereiste op.
- SPF-, DKIM- en DMARC-records worden automatisch voor u aangemaakt op een API DNS-backend. Bij de Wildcard- of Manual-backends voegt u deze handmatig toe; een ontbrekend DKIM-record betekent dat elk bericht dat u ondertekent onverifieerbaar is.
De configuratie die voor de meeste mensen werkt, is het ontvangen van e-mail op Cloudron en het versturen via een relay zoals SendGrid, Postmark, Mailgun of Amazon SES, geconfigureerd in het Email-overzicht. De relay moet toestaan dat er wordt verzonden als elk adres op uw domein, anders worden app-notificaties van verschillende afzenders geweigerd. Als e-mail de voornaamste reden is voor de aanschaf van de server, draai dan een toegewijde mailserver zoals Mailcow op een eigen machine met een eigen IP-reputatie.
Als u Cloudron Email helemaal niet gebruikt, blokkeer dan poorten 25, 465, 587, 993 en 4190 in de firewall van uw provider. Doe dit daar en niet op de server zelf, omdat Cloudron de iptables-regels zelf schrijft en verwacht deze in beheer te hebben. Dat is het tegenovergestelde van een standaard VPS, waar u zelf ufw-regels beheert.
Configureer het back-updoel voordat u het nodig heeft
Back-ups worden standaard opgeslagen op het lokale bestandssysteem op /var/backups, op dezelfde schijf als de rest van de data. De documentatie is hierover duidelijk: "Het opslaan van back-ups op dezelfde fysieke schijf als de platformserver is riskant." Eén defecte schijf vernietigt zowel de applicaties als de back-ups.
Open Backups, ga naar Backup Sites en wijs vanaf de eerste dag een andere locatie aan. S3-compatibele objectopslag is de gebruikelijke keuze (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces of een MinIO-bucket op een tweede server), maar ook SSHFS, NFS, CIFS en standaard bestandssysteemdoelen worden ondersteund.
Drie instellingen bepalen of een back-up daadwerkelijk bruikbaar is:
- Formaat.
tgzschrijft één gecomprimeerd archief per app en uploadt bij elke run het volledige bestand opnieuw.rsyncuploadt alleen gewijzigde bestanden, wat voor een grote Nextcloud-installatie aanzienlijk goedkoper is, maar wel meer verzoeken aan de storage-API vereist. - Versleuteling. Optionele AES-256-versleuteling voor zowel de bestandsinhoud als de bestandsnamen. Cloudron bewaart geen kopie van het wachtwoord; als u dit verliest, kunnen de back-ups door niemand meer worden ontsleuteld, ook niet door uzelf. Sla het wachtwoord op in een zelfgehoste wachtwoordmanager voordat u op opslaan klikt.
- Retentie. Dit wordt gedefinieerd in aantallen, zoals 7 dagelijkse en 4 wekelijkse back-ups. Een lange retentieperiode bij objectopslag brengt maandelijkse kosten met zich mee; kies daarom een aantal waarvoor u bereid bent te blijven betalen.
Test vervolgens een herstelprocedure. Installeer een kleine app, herstel deze via het dashboard en controleer of de data correct wordt teruggezet. Een back-up die nooit is getest, is slechts een aanname.
Wat de limieten van het gratis abonnement inhouden
Sinds oktober 2026 is het gratis abonnement beperkt tot twee geïnstalleerde apps. Alle overige functies zijn inbegrepen: app-updates, back-ups per app, de firewall, de mailserver en single sign-on. Bij de derde app is een licentie vereist. De betaalde abonnementen heffen de app-limiet op, en het uitgebreidere abonnement voegt gebruikersgroepen en rollen, een directoryserver en meerdere back-uplocaties toe. Prijzen wijzigen, dus raadpleeg de Cloudron-prijzenpagina in plaats van uit te gaan van een bedrag in een handleiding.
Een licentie dekt één Cloudron-installatie, waardoor twee kleine servers twee keer zoveel kosten als één grotere server. Dit prijsmodel stimuleert de meeste gebruikers om één grotere VPS te gebruiken, wat ingaat tegen het gebruikelijke advies om services over meerdere machines te verspreiden. Houd hier rekening mee bij het bepalen van de grootte van de server, aangezien het later opsplitsen betekent dat u dubbel betaalt.
Wanneer er iets defect raakt
Begin met de ingebouwde controle. Deze doorloopt DNS, certificaten, schijfgebruik, geheugen en elke service afzonderlijk, en geeft aan welke test is mislukt:
sudo cloudron-support --troubleshootGebruik daarna de standaard tools van systemd (de system and service manager). systemctl status box rapporteert over de Cloudron-service zelf, journalctl -u box -n 100 toont de recente logs en journalctl -u docker behandelt de onderliggende container runtime. Alles wat tijdens de installatie is misgegaan, staat in /var/log/cloudron-setup.log.
Een dashboard dat niet laadt, heeft meestal te maken met DNS of de firewall van de provider, en niet met Cloudron. Voer dig +short my.example.com uit vanaf uw laptop en bevestig dat poort 80 en 443 openstaan in de netwerkfirewall van de provider; dit is een aparte instelling die losstaat van de eigen regels van de server. Bij de installatiecontrole van 13 oktober 2026 werd een tweede poging geweigerd met Error: Cloudron is already installed. To reinstall, start afresh; een opnieuw opgebouwde server is in dat geval de schone oplossing.
Wanneer Cloudron niet de juiste keuze is
Cloudron is geschikt wanneer u applicaties wilt draaien en geen infrastructuur wilt beheren. Het is minder geschikt wanneer u uw eigen containers op uw eigen manier wilt beheren, omdat het systeem beheer voert over Nginx, Docker en de firewall; handmatige wijzigingen worden door Cloudron overschreven. Als u van plan bent om met een map vol compose-bestanden te werken, biedt Traefik voor uw eigen Docker Compose-stacks dezelfde automatische TLS-afhandeling en subdomein-routing zonder dat daar een platform bovenop ligt. Als u nog geen keuze heeft gemaakt, vergelijkt Cloudron, CasaOS en Coolify vergeleken deze opties, en is de uitgebreidere lijst met zelf te hosten software een beter startpunt dan een installatiehandleiding.
FAQ
Hoeveel RAM heeft Cloudron nodig op een VPS?
De installer-check van 13 oktober 2026 weigerde te draaien met minder dan 941 MB; de huidige documentatie vraagt om 2 GB, maar dat is de ondergrens voor het platform zonder applicaties. Cloudron draait Docker, nginx, zijn eigen box-service en de mail-stack, en provisioneert gedeelde databaseservices zodra applicaties worden uitgerold. Reken op 4 GB voor twee applicaties en 16 GB voor ongeveer tien applicaties. Voeg een swap-bestand toe, omdat Cloudron applicaties onbeperkte swap geeft; een server zonder swap vertaalt geheugendruk naar herstarts.
Kan ik Cloudron installeren op Debian, of op een server die al Docker draait?
Beide werken niet. In de installer-check van 13 oktober 2026 stopte het script bij niet-ondersteunde releases met Cloudron requires Ubuntu 22.04, 24.04, 26.04 en weigerde het servers met nginx, docker of node al aanwezig. De huidige installatiedocumentatie vereist een schone Ubuntu-image en sluit Debian, Rocky en Alpine uit. Begin met een schone Ubuntu-image op een KVM VPS.
Waarom falen mijn applicatie-subdomeinen terwijl het dashboard wel werkt?
Controleer bij de Wildcard-backend het wildcard DNS-record. De installatie maakt een A-record aan voor my.example.com, of vereist dit, waardoor het dashboard resolveert, terwijl wiki.example.com een NXDOMAIN-fout geeft en de browser meldt dat de site niet gevonden kan worden. Voeg een A-record toe voor *.example.com dat naar het server-IP wijst en bevestig dit met dig +short wiki.example.com voordat u de applicatie installeert.
Moet ik de Cloudron-mailserver gebruiken?
Nee. U kunt inkomende e-mail uitschakelen en versturen via een externe relay zoals Postmark, Mailgun of Amazon SES. Dit is de veiligere keuze wanneer uw provider uitgaande poort 25 blokkeert of wanneer het IP-adres geen mail-reputatie heeft. Als u Cloudron Email volledig overslaat, sluit dan poorten 25, 465, 587, 993 en 4190 in de firewall van de provider in plaats van op de server zelf.
Wat gebeurt er wanneer ik de limiet van twee applicaties op het gratis abonnement bereik?
U heeft een betaald abonnement nodig om een derde applicatie te installeren. Applicaties die al draaien blijven onaangeroerd: ze blijven updates ontvangen, worden geback-upt en behouden hun certificaten. Het toevoegen van een abonnement heft de limiet op zonder dat er iets opnieuw geïnstalleerd hoeft te worden. Het gratis abonnement is daarom een geschikte manier om het platform eerst op een echt domein te testen.