Dedicated Server: One-Click Apps

Met One-Click Apps installeer je toepassingen zoals Nextcloud, n8n, databases of monitoringtools uit een appcatalogus op je dedicated server en beheer je ze rechtstreeks in het ZapX-dashboard. Op de achtergrond draait Coolify, een opensourceplatform voor containerapps.

In tegenstelling tot bij VPS stel je apps met één klik op een dedicated server eenmalig zelf in: je maakt in het dashboard een opdracht aan en voert die als root uit op je server. ZapX doet de rest. In deze handleiding lees je wat je server hiervoor nodig heeft, hoe de installatie werkt, hoe je apps beheert en wat de onderhoudstoegang van ZapX op je server doet.

Alleen de eigenaar van de server kan apps met één klik instellen.

Open je dedicated server in het ZapX-dashboard en ga naar het tabblad One-Click Apps. Daar zie je de kaart One-Click Apps instellen.

Kies twee gegevens:

• IP-adres voor panel en apps: Hier staan de openbare IPv4-adressen van je server. Het primaire adres is gemarkeerd. Het Coolify-panel en je apps zijn later bereikbaar via dit IP-adres.
• Admin-e-mailadres voor Coolify: Met dit e-mailadres meld je je aan bij het Coolify-panel.

Klik daarna op Opdracht maken. ZapX maakt het adres voor je panel klaar. Dit kan maximaal een minuut duren.

Meld je via SSH als root aan op je server. Kopieer de weergegeven opdracht met het kopieerpictogram en voer deze uit. De opdracht begint met curl -fsSL en eindigt met | bash.

Ontbreekt curl op je server? Installeer het dan eerst met:

apt update && apt install -y curl

Daarna gaat de installatie op de achtergrond verder. Je kunt de terminal sluiten.

Op het tabblad zie je hoever de installatie is:

Kan ZapX je server na een paar minuten nog steeds niet via SSH bereiken? Dan verschijnt er een melding op het tabblad. Controleer of je firewall inkomende verbindingen op de SSH-poort van je server toestaat.

• De opdracht controleert het besturingssysteem, de resources, het IP-adres en de vrije poorten. Als er iets niet klopt, stopt de opdracht met een melding.
• De opdracht maakt de gebruiker zapx-apps aan met sudo-rechten. ZapX gebruikt deze gebruiker om Coolify en je apps te beheren. Aanmelden kan alleen met een sleutel van ZapX en alleen vanaf ZapX-adressen. Aanmelden met een wachtwoord is niet mogelijk.
• De opdracht installeert Coolify met het officiële installatieprogramma, dat ook Docker instelt.
• Voor de installatie gebruikt ZapX tijdelijk een sterk beperkte rootsleutel en past zo nodig de SSH-configuratie aan. Beide worden na de installatie weer verwijderd.
• De opdracht wijzigt geen firewallregels.

Je vindt het installatielogboek op de server onder /var/lib/zapx-oneclick-apps/setup.log.

Zodra de installatie is voltooid, zie je op het tabblad One-Click Apps drie onderdelen:

1. Open de App-catalogus en zoek de gewenste app.
2. Klik op Installeren.
3. Vul in het venster App installeren de gevraagde gegevens in, bijvoorbeeld [dein_appname] of [deine_domain].
4. Klik op Installatie in wachtrij plaatsen.

Is er niet genoeg RAM op je server voor een app? Dan zie je in de catalogus de melding ‘Je server heeft te weinig RAM voor deze app.’

Onder Geïnstalleerde apps beheer je elke app rechtstreeks:

De kaart Onderhoudstoegang laat zien of ZapX je server kan bereiken:

Met Toegang verwijderen verwijdert ZapX de sleutel, de sudo-regel en de gebruiker zapx-apps van je server. Coolify en je apps blijven actief, maar ZapX kan ze niet meer beheren. Installeren, problemen oplossen en wijzigingen aanbrengen in het dashboard zijn dan niet meer mogelijk. In dat geval beheer je je apps rechtstreeks in het Coolify-panel.

Is je server niet bereikbaar wanneer je de toegang verwijdert? Dan blokkeert ZapX de toegang aan zijn kant. Je kunt de gebruiker zapx-apps en het bestand /etc/sudoers.d/zapx-apps daarna zelf van de server verwijderen.

Met Toegang herstellen maak je een nieuwe opdracht aan die alleen de onderhoudstoegang opnieuw instelt. Coolify en je apps blijven ongewijzigd. Voer de opdracht net als bij de installatie als root uit op je server.

Meer informatie over een mislukte installatie vind je in /var/lib/zapx-oneclick-apps/setup.log. Kom je er niet uit? Maak dan een supportticket aan en vermeld de foutmelding van het tabblad.