Die One-Click-Apps-Funktion ermöglicht dir, durch einen umfangreichen App-Katalog zu stöbern und Apps direkt über die Weboberfläche deines vServers zu deployen. In dieser Anleitung lernst du, wie du deinen Server vorbereitest, den richtigen Installationstyp auswählst, Apps installierst und verwaltest sowie erweiterte Einstellungen und Troubleshooting-Tools bei Bedarf nutzt.
Bevor du die One-Click Apps nutzt, muss dein vServer die Mindestanforderungen erfüllen und ein unterstütztes Betriebssystem verwenden.
Mindestanforderungen Die Apps-Funktion benötigt, dass dein vServer online ist und mit ausreichend Ressourcen konfiguriert wurde, um sowohl die Plattformdienste als auch deine installierten Apps zuverlässig auszuführen.
| Anforderung | Minimum | Empfohlen |
|---|---|---|
| Serverstatus | Online | Online |
| Speicherplatz | 30 GB | 50 GB |
| RAM | 2 GB | 4 GB |
| CPU | 2 Kerne | 4 Kerne |
| Betriebssystem | Debian oder Ubuntu LTS | Debian 13 |
Frisches Betriebssystem empfohlen Es wird dringend empfohlen, die Apps-Funktion auf einer frischen Betriebssysteminstallation einzurichten. So vermeidest du Konflikte mit bestehenden Diensten, belegten Ports, Docker-Setups oder individuellen Konfigurationen, die bereits auf dem Server vorhanden sind.
Falls du deinen vServer neu installieren musst, nutze ein frisches, unterstütztes Debian- oder Ubuntu LTS-Image aus deinem vServer-Management-Interface.
Nach dem Deployment werden deine installierten Apps im Verwaltungsbereich des Tabs aufgelistet. Von hier aus kannst du deine Services überwachen und steuern, ohne manuell mit den zugrundeliegenden Containern arbeiten zu müssen.
Der Bereich für installierte Apps erlaubt dir, gängige Lifecycle-Aktionen direkt im Tab auszuführen.
| Aktion | Zweck |
|---|---|
| Starten | Startet eine gestoppte App |
| Stoppen | Stoppt eine laufende App |
| Logs prüfen | Öffnet die App-Logs zur Fehlerbehebung |
| Neu installieren | Setzt die App neu auf |
Diese Tools erleichtern die Verwaltung aller Apps an einem Ort, besonders wenn du einfache Web-basierte Kontrolle statt manueller Kommandozeilenarbeit bevorzugst.
Projekte und Umgebungen helfen dir, deine Deployments klar zu strukturieren. Du kannst sie nutzen, um zu trennen:
- private und produktive Apps
- Test- und Live-Umgebungen
- mehrere Kunden- oder Team-Deployments
- verschiedene Stacks auf demselben vServer
Diese Organisation wird immer wichtiger, je größer deine App-Store-App-Sammlung wird und je mehr Services du auf einem oder mehreren Nodes verwaltest.
Die One-Click-Apps-Funktion unterstützt eigene Domains und die ZAP Cloud-Integration. So kannst du Apps sicher zugänglich machen und SSL-Zertifikate für deine Deployments bereitstellen.
Domain- und SSL-Unterstützung Du kannst eigene Domains für deine Apps verwenden und von der automatischen SSL-Zertifikatsbereitstellung profitieren, sofern die Plattform das Setup unterstützt.
Beim Zuweisen einer Domain stelle sicher, dass deine DNS-Einträge auf [deine_server_ip] zeigen. Wenn deine Domain nicht korrekt konfiguriert ist, wird die App möglicherweise nicht aus dem Internet erreichbar sein.
| Wert | Beschreibung |
|---|---|
[deine_domain] | Die Domain oder Subdomain, die deiner App zugewiesen ist |
[deine_server_ip] | Die öffentliche IP-Adresse deines vServers |
DNS muss auf deinen vServer zeigen
Wenn der DNS für [deine_domain] nicht auf [deine_server_ip] zeigt, kann die Domainvalidierung und der App-Zugriff fehlschlagen.
Wenn das Dashboard einen degradierten Status anzeigt, bedeutet das, dass die Plattform die Instanz, die die One-Click-Apps-Funktion betreibt, nicht erreichen oder keine Daten abrufen kann. Folge den Troubleshooting-Schritten in chronologischer Reihenfolge.
Das Troubleshooting-Popup kann folgende Indikatoren anzeigen:
| Status | Bedeutung |
|---|---|
| Coolify Status: Aktiv | Der Panel-Dienst scheint zu laufen |
| API Status: Erreichbar | Die API ist aktuell erreichbar |
| Service Status: Online | Dein vServer selbst ist online |
Wenn ein oder mehrere Teile nicht korrekt funktionieren, fahre mit den folgenden Schritten fort.
Stelle zuerst sicher, dass dein vServer im ZapX-Dashboard online ist. Wenn der Server offline ist, kann die Apps-Plattform nicht funktionieren.
Nutze die Aktion Status aktualisieren, um den Gesundheitscheck mit den neuesten Daten erneut auszuführen. Das kann temporäre Verbindungsprobleme beheben.
Temporäre Verbindungsprobleme Ein degradierten Zustand kann manchmal durch kurzzeitige Kommunikationsprobleme verursacht werden. Das Aktualisieren des Status ist der schnellste erste Check.
Bleibt der Status degradiert, nutze die Aktion Docker neu starten. Dadurch wird die Plattform-Instanz neu gestartet. Nach erfolgreicher Rückmeldung warte 1-2 Minuten und aktualisiere den Status erneut.
Dienstneustart Das Neustarten von Docker kann laufende Apps vorübergehend unterbrechen, während die Dienste neu starten.
Als letzten Schritt nutze Zugangsdaten aktualisieren. Das ist besonders wichtig, wenn der Status online anzeigt, aber Funktionen im Dashboard wie App-Installation nicht funktionieren.
Diese Aktion:
- löscht nicht deine Daten
- aktualisiert die Root-Benutzer-Zugangsdaten
- erneuert den API-Token, der vom Dashboard genutzt wird
- aktualisiert die Panel-Zugangsdaten automatisch bei Erfolg
Sicheres Aktualisieren der Zugangsdaten Das Aktualisieren der Zugangsdaten entfernt keine installierten Apps oder Deployment-Daten. Es erneuert nur die für Zugriff und Kommunikation benötigten Zugangsdaten.
Wenn das Problem nach allen Troubleshooting-Schritten weiterhin besteht, erstelle bitte ein Support-Ticket über die ZAP-Hosting Webseite.
Damit die One-Click Apps stabil und einfach zu verwalten bleiben, beachte diese Empfehlungen:
| Best Practice | Grund |
|---|---|
| Frische OS-Installation nutzen | Vermeidet Konflikte mit bestehenden Diensten und Ports |
| Empfohlene Ressourcen erfüllen | Verbessert Performance und Zuverlässigkeit |
| Apps in Projekte und Umgebungen organisieren | Hält Deployments übersichtlich |
| DNS vor Domain-Zuweisung konfigurieren | Verhindert Zugriffs- und SSL-Probleme |
| Erweiterte Einstellungen mit Bedacht nutzen | Vermeidet nicht unterstützte individuelle Änderungen |
Deployments organisiert halten
Wenn du viele Apps hosten möchtest, erstelle vor dem ersten Deployment ein klares Namensschema für [dein_projektname], [dein_umgebungsname] und [dein_appname].
Bevorzugte Quelle bei Google
