Coolify is een open-source, zelfgehost alternatief voor Heroku en Vercel waarmee je je servers, applicaties en databases heel eenvoudig kunt beheren.
Het intuïtieve dashboard van Coolify maakt zelf hosten kinderspel. Je hebt volledige controle over je infrastructuur, kunt GitHub-deployments automatiseren en houdt je cloudkosten laag.
In deze handleiding laten we je stap voor stap zien hoe je Coolify instelt, je beheerdersaccount vooraf configureert en alles instelt wat je moet weten.
Coolify is lichtgewicht, maar het resourcegebruik kan sterk toenemen afhankelijk van het aantal gedeployde apps, Docker-builds en actieve databases. We raden de volgende hardwarevereisten aan voor Coolify op je VPS/dedicated server:
| Hardware | Minimum | Aanbevolen |
|---|---|---|
| CPU | 2 vCPU-kernen | 4 vCPU-kernen |
| RAM | 2 GB | 4 GB+ |
| Schijfruimte | 30 GB | 50 GB+ |
Voordat je Coolify installeert, maak je verbinding met je server en controleer je of het besturingssysteem up-to-date is. Je moet via SSH verbinding maken met root-toegang. Hulp nodig? Bekijk onze handleiding voor de eerste SSH-verbinding.
SSH-sleutelauthenticatie
We raden sterk aan om SSH-sleutelauthenticatie in te stellen in plaats van een wachtwoord te gebruiken. Lees in onze handleiding SSH-sleutel instellen hoe je dat doet.
Nadat je verbinding hebt gemaakt met je server, werk je de systeempakketten bij en installeer je curl, dat nodig is om het Coolify-installatiescript te downloaden:
sudo apt update && sudo apt upgrade -y && sudo apt install curl -y
Coolify hanteert strenge beveiligingsregels voor je beheerdersaccount. Bereid de inloggegevens van je rootgebruiker voor volgens deze vereisten voordat je het installatiescript start:
- Gebruikersnaam
- Minimaal 3 tekens lang
- Maximaal 255 tekens
- Alleen letters, cijfers, spaties, underscores en koppeltekens zijn toegestaan
- E-mailadres
- Moet een geldig e-mailadres zijn
- Moet een geldige DNS-vermelding hebben
- Maximaal 255 tekens
- Wachtwoord
- Minimaal 8 tekens lang
- Moet hoofdletters en kleine letters bevatten
- Minimaal één cijfer
- Minimaal één speciaal teken
- Mag geen veelgebruikt of gecompromitteerd wachtwoord zijn
Coolify biedt een snel, geautomatiseerd installatiescript. Om de installatie te beveiligen, stellen we de rootbeheerdersgegevens vooraf in met omgevingsvariabelen. Zo voorkom je ongeautoriseerde toegang tijdens de installatie.
Voer de volgende opdracht uit en vervang de gebruikersnaam, het e-mailadres en het wachtwoord door je veilige inloggegevens:
env ROOT_USERNAME=zaphosting ROOT_USER_EMAIL=info@zap-hosting.com ROOT_USER_PASSWORD=zaphosting bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
Open source
Je vindt de broncode van het installatiescript in de officiële Coolify-repository
Het script installeert Docker automatisch, stelt de benodigde netwerken in en configureert de Coolify-containers. Afhankelijk van de hardware van je server kan dit enkele minuten duren.
Na de installatie kun je het dashboard openen in je browser. Voer het IP-adres van je server in met poort 8000: http://[deine_server_ip]:8000
Omdat je je inloggegevens al tijdens het uitvoeren van de installatieopdracht hebt opgegeven, kom je direct op het inlogscherm terecht en niet in de installatiewizard.
Log in met het e-mailadres en wachtwoord dat je in de terminal hebt gebruikt.
Na het inloggen stel je als eerste een eigen domein in. Toegang via het IP-adres (http://[deine_server_ip]:8000) is onveilig.
Met een domein kan Coolify automatisch gratis SSL-certificaten aanmaken voor je dashboard en alle toekomstige apps.
Ga naar het DNS-beheer van je domeinprovider en voeg twee nieuwe A-records toe die naar je server verwijzen. Als je domein bij ZAP-Hosting is geregistreerd, helpt onze handleiding voor domeinrecords je bij het instellen:
| Naam / Host | Type | Waarde | TTL |
|---|---|---|---|
@ | A | [deine_server_ip] | Auto / Laag |
* | A | [deine_server_ip] | Auto / Laag |
DNS-routering
- Met het
@-record kan Coolify het hoofddomein gebruiken - Het wildcardrecord
*zorgt ervoor dat Coolify automatisch alle nieuwe subdomeinen (bijv.api.[deine_domain]) routeert, zonder dat je voor elk project DNS-records hoeft aan te maken.
Wijs je Coolify-instantie een domein toe om deze met een SSL-certificaat te beveiligen. Ga in het linkermenu naar Instellingen en zoek het veld Instance Domain. Voer je domein in, inclusief https:// (bijv. https://coolify.[deine_domain]). Sla de wijziging op.
