Mit One-Click Apps installierst du Anwendungen wie Nextcloud, n8n, Datenbanken oder Monitoring-Tools aus einem App-Katalog auf deinem Dedicated Server und verwaltest sie direkt im ZapX-Dashboard. Im Hintergrund läuft dafür Coolify, eine Open-Source-Plattform für Container-Apps.
Anders als beim vServer richtest du One-Click Apps auf einem Dedicated Server einmalig selbst ein: Du erstellst im Dashboard einen Befehl und führst ihn als root auf deinem Server aus. Den Rest erledigt ZapX. In dieser Anleitung erfährst du, was dein Server dafür braucht, wie die Einrichtung abläuft, wie du Apps verwaltest und was der Wartungszugang von ZapX auf deinem Server macht.
Das braucht dein Dedicated Server: Prüfe diese Punkte, bevor du den Befehl ausführst. Der Befehl kontrolliert sie selbst und bricht ohne Änderungen ab, wenn etwas nicht passt.
| Anforderung | Minimum |
|---|---|
| Betriebssystem | Debian oder Ubuntu mit SSH-Server |
| RAM | 2 GB |
| CPU | 2 Kerne |
| Freier Speicher | 30 GB |
| IP-Adresse | Öffentliche IPv4-Adresse, die auf dem Server eingerichtet ist |
| Freie Ports | 8000, 6001, 6002 und 8080 (80 und 443 brauchen deine Apps) |
| SSH | Der SSH-Port deines Servers muss für ZapX erreichbar sein |
Frisches Betriebssystem empfohlen: Richte One-Click Apps am besten auf einer frischen Debian- oder Ubuntu-Installation ein. Dienste, die schon Ports belegen, ein eigenes Docker-Setup oder ein bereits installiertes Coolify mit eigenem Login führen zum Abbruch der Einrichtung. Eine Neuinstallation startest du im Tab Installation deines Dedicated Servers.
Proxmox-Host und Windows: Auf einem Proxmox-Host selbst lässt sich One-Click Apps nicht einrichten. Nutze dafür eine VM auf dem Server, die eine der IP-Adressen deines Servers verwendet. Windows wird nicht unterstützt.
Nur der Inhaber des Servers kann One-Click Apps einrichten.
Öffne deinen Dedicated Server im ZapX-Dashboard und wechsle zum Tab One-Click Apps. Dort siehst du die Karte One-Click Apps einrichten.
Wähle zwei Angaben aus:
- IP-Adresse für Panel und Apps: Hier stehen die öffentlichen IPv4-Adressen deines Servers, die primäre ist markiert. Unter dieser IP sind später das Coolify-Panel und deine Apps erreichbar.
- Admin-E-Mail für Coolify: Mit dieser E-Mail-Adresse meldest du dich im Coolify-Panel an.
Klicke dann auf Befehl erstellen. ZapX bereitet dabei die Adresse für dein Panel vor, das kann bis zu einer Minute dauern.
Melde dich per SSH als root auf deinem Server an. Kopiere den angezeigten Befehl mit dem Kopieren-Symbol und führe ihn aus. Er beginnt mit curl -fsSL und endet mit | bash.
Fehlt auf deinem Server curl, installierst du es vorher mit:
apt update && apt install -y curl
Die Installation läuft danach im Hintergrund weiter. Du kannst das Terminal schließen.
Befehl nicht weitergeben: Der Befehl enthält einen persönlichen Schlüssel für genau diesen Server und ist 24 Stunden gültig. Gib ihn nicht weiter. Brauchst du einen neuen Befehl, klicke auf Manuelle Installation abbrechen und erstelle ihn neu.
Im Tab siehst du, wie weit die Einrichtung ist:
| Anzeige | Bedeutung |
|---|---|
| Wir warten darauf, dass du den Befehl auf deinem Server ausführst. | Der Befehl wurde noch nicht gestartet |
| Verbunden. Die Installation läuft auf deinem Server. | ZapX installiert Coolify, das dauert meist bis zu 10 Minuten |
| Coolify ist installiert. Wir verbinden gerade das Panel. | Letzter Schritt, dauert etwa eine Minute |
Kann ZapX deinen Server auch nach einigen Minuten nicht per SSH erreichen, zeigt der Tab einen Hinweis. Prüfe dann, ob deine Firewall den SSH-Port deines Servers für eingehende Verbindungen freigibt.
- Er prüft Betriebssystem, Ressourcen, IP-Adresse und freie Ports und bricht mit einer Meldung ab, wenn etwas nicht passt.
- Er legt den Benutzer
zapx-appsmit sudo-Rechten an. Über diesen Benutzer verwaltet ZapX Coolify und deine Apps. Die Anmeldung funktioniert nur mit einem Schlüssel von ZapX und nur von ZapX-Adressen aus, ein Passwort-Login gibt es nicht. - Er installiert Coolify mit dem offiziellen Installer, der auch Docker einrichtet.
- Für die Einrichtung selbst nutzt ZapX kurzzeitig einen stark eingeschränkten root-Schlüssel und passt falls nötig die SSH-Konfiguration an. Beides wird nach der Einrichtung wieder entfernt.
- Firewall-Regeln ändert der Befehl nicht.
Das Protokoll der Einrichtung findest du auf dem Server unter /var/lib/zapx-oneclick-apps/setup.log.
Ist die Einrichtung abgeschlossen, zeigt der Tab One-Click Apps drei Bereiche:
| Bereich | Inhalt |
|---|---|
| Installierte Apps | Deine Apps mit Status und Aktionen |
| App-Katalog | Alle verfügbaren Apps zum Installieren |
| Zugang & Einstellungen | Panel-Adresse, Login und Wartungszugang |
- Öffne den App-Katalog und suche die gewünschte App.
- Klicke auf Installieren.
- Fülle im Fenster App installieren die abgefragten Werte aus, zum Beispiel
[dein_appname]oder[deine_domain]. - Klicke auf Installation einreihen.
Reicht der RAM deines Servers für eine App nicht aus, siehst du im Katalog den Hinweis „Dein Server hat zu wenig RAM für diese App.“
Hilfe vom ZapX AI Agent: Im ZapX AI Agent deines Servers kannst du dir eine passende App vorschlagen lassen, den Status deiner Apps prüfen oder eine Installation vorbereiten. Jede Änderung führt der Agent erst nach deiner Bestätigung aus. Zugangsdaten und Geheimnisse bearbeitest du immer im Tab One-Click Apps.
Unter Installierte Apps steuerst du jede App direkt:
| Aktion | Zweck |
|---|---|
| Starten | Startet eine gestoppte App |
| Stoppen | Stoppt eine laufende App |
| Neustarten | Startet die App neu |
| Logs | Zeigt die Logs der App zur Fehlersuche |
| Einstellungen | Ändert Umgebungswerte, Domain und weitere Optionen der App |
Die Karte Wartungszugang zeigt, ob ZapX deinen Server erreicht:
| Status | Bedeutung |
|---|---|
| Aktiv | ZapX erreicht deinen Server und verwaltet Coolify und deine Apps |
| Unterbrochen | ZapX erreicht deinen Server nicht mehr, zum Beispiel weil sich der SSH-Hostschlüssel geändert hat oder der Schlüssel von ZapX nicht mehr angenommen wird |
| Entfernt | Du hast den Wartungszugang entfernt |
Mit Zugang entfernen löscht ZapX seinen Schlüssel, die sudo-Regel und den Benutzer zapx-apps von deinem Server. Coolify und deine Apps laufen weiter, ZapX kann sie aber nicht mehr verwalten: Installieren, Fehlerbehebung und Änderungen im Dashboard funktionieren dann nicht mehr. Du verwaltest deine Apps in diesem Fall direkt im Coolify-Panel.
Ist dein Server beim Entfernen nicht erreichbar, sperrt ZapX den Zugang auf seiner Seite. Den Benutzer zapx-apps und die Datei /etc/sudoers.d/zapx-apps kannst du dann selbst auf dem Server löschen.
Mit Zugang wiederherstellen erstellst du einen neuen Befehl, der nur den Wartungszugang neu einrichtet. Coolify und deine Apps bleiben dabei unverändert. Führe ihn wie bei der Einrichtung als root auf deinem Server aus.
| Ereignis | Was passiert |
|---|---|
| Neuinstallation über den Tab Installation | Die Einrichtung wird zurückgesetzt und die Adressen unter zap.cloud werden gelöscht. Das System wird neu aufgesetzt, sichere deine App-Daten vorher. Danach richtest du One-Click Apps neu ein. |
| Freigabe der IP-Adresse von Panel und Apps | Der Wartungszugang wird entfernt, die Adressen unter zap.cloud werden gelöscht und die Einrichtung wird zurückgesetzt. Coolify und deine Apps laufen auf dem Server weiter. Um sie wieder im Dashboard zu verwalten, richtest du One-Click Apps mit einer anderen IP-Adresse neu ein. |
| Kündigung oder Vertragsende | Der Wartungszugang und die Adressen unter zap.cloud werden entfernt. |
| Meldung oder Problem | Lösung |
|---|---|
| Keine Verbindung per SSH nach einigen Minuten | Prüfe, ob der SSH-Server läuft und deine Firewall den SSH-Port freigibt |
| Ports sind bereits belegt | Beende die Dienste auf den Ports 8000, 6001, 6002 und 8080 oder installiere den Server neu |
| Coolify ist bereits installiert | Ein Coolify mit eigenem Login übernimmt ZapX nicht. Entferne es oder nutze ein frisches System |
| Dein SSH-Server lässt nur bestimmte Benutzer zu (AllowUsers) | Ergänze zapx-apps in deiner SSH-Konfiguration und führe den Befehl erneut aus |
| Auf dem Server läuft gerade eine Installation | Warte, bis die Installation im Tab Installation abgeschlossen ist |
| Der Server hat noch keine öffentliche IPv4-Adresse | Richte zuerst eine öffentliche IPv4-Adresse für deinen Server ein |
| Zu viele Versuche | Warte ein paar Minuten und erstelle den Befehl dann neu |
Weitere Details zu einer fehlgeschlagenen Einrichtung stehen in /var/lib/zapx-oneclick-apps/setup.log. Kommst du nicht weiter, erstelle ein Support-Ticket und nenne die Fehlermeldung aus dem Tab.
Bevorzugte Quelle bei Google
