Avec les One-Click Apps, tu installes des applications comme Nextcloud, n8n, des bases de données ou des outils de monitoring depuis un catalogue d’applications sur ton serveur dédié, puis tu les gères directement dans le tableau de bord ZapX. En arrière-plan, Coolify, une plateforme open source pour les applications conteneurisées, s’occupe de tout.
Contrairement à un VPS, tu configures toi-même les applications en un clic une seule fois sur un serveur dédié : tu crées une commande dans le tableau de bord et tu l’exécutes en tant que root sur ton serveur. ZapX s’occupe du reste. Dans ce guide, tu découvriras les prérequis de ton serveur, les étapes de configuration, la gestion des applications et le rôle de l’accès de maintenance ZapX sur ton serveur.
Ton serveur dédié doit répondre à ces exigences : vérifie ces points avant d’exécuter la commande. Elle les contrôle elle-même et s’interrompt sans rien modifier si un point ne convient pas.
| Exigence | Minimum |
|---|---|
| Système d’exploitation | Debian ou Ubuntu avec un serveur SSH |
| RAM | 2 Go |
| CPU | 2 cœurs |
| Espace disque libre | 30 Go |
| Adresse IP | Adresse IPv4 publique configurée sur le serveur |
| Ports libres | 8000, 6001, 6002 et 8080 (tes applications ont besoin des ports 80 et 443) |
| SSH | Le port SSH de ton serveur doit être accessible par ZapX |
Un système d’exploitation vierge est recommandé : configure de préférence les applications en un clic sur une installation Debian ou Ubuntu vierge. Les services qui utilisent déjà des ports, une configuration Docker personnalisée ou une installation existante de Coolify avec son propre identifiant de connexion entraînent l’interruption de la configuration. Pour lancer une réinstallation, ouvre l’onglet Installation de ton serveur dédié.
Hôte Proxmox et Windows : tu ne peux pas configurer les applications en un clic directement sur un hôte Proxmox. Utilise plutôt une VM sur le serveur, qui utilise l’une des adresses IP de ton serveur. Windows n’est pas pris en charge.
Seul le propriétaire du serveur peut configurer les applications en un clic.
Ouvre ton serveur dédié dans le tableau de bord ZapX, puis va dans l’onglet One-Click Apps. Tu y trouveras la carte Configurer les One-Click Apps.
Choisis deux paramètres :
- Adresse IP du panneau et des apps : tu y trouveras les adresses IPv4 publiques de ton serveur. L’adresse principale est indiquée. Le panneau Coolify et tes applications seront accessibles via cette adresse IP.
- E-mail admin pour Coolify : tu utiliseras cette adresse e-mail pour te connecter au panneau Coolify.
Clique ensuite sur Créer une commande. ZapX prépare alors l’adresse de ton panneau, ce qui peut prendre jusqu’à une minute.
Connecte-toi à ton serveur en SSH en tant que root. Copie la commande affichée à l’aide de l’icône de copie, puis exécute-la. Elle commence par curl -fsSL et se termine par | bash.
Si curl n’est pas installé sur ton serveur, installe-le au préalable avec :
apt update && apt install -y curl
L’installation se poursuit ensuite en arrière-plan. Tu peux fermer le terminal.
Ne partage pas la commande : elle contient une clé personnelle propre à ce serveur et reste valable pendant 24 heures. Ne la partage pas. Si tu as besoin d’une nouvelle commande, clique sur Annuler l’installation manuelle et génère-en une nouvelle.
L’onglet affiche l’état d’avancement de la configuration :
| Affichage | Signification |
|---|---|
| Nous attendons que tu exécutes la commande sur ton serveur. | La commande n’a pas encore été lancée |
| Connecté. L’installation est en cours sur ton serveur. | ZapX installe Coolify, ce qui prend généralement jusqu’à 10 minutes |
| Coolify est installé. Nous connectons le panneau. | Dernière étape, qui dure environ une minute |
Si ZapX n’arrive toujours pas à se connecter à ton serveur en SSH après quelques minutes, un message s’affiche dans l’onglet. Vérifie alors que ton pare-feu autorise les connexions entrantes sur le port SSH de ton serveur.
- Elle vérifie le système d’exploitation, les ressources, l’adresse IP et les ports libres. Si un point ne convient pas, elle s’interrompt et affiche un message.
- Elle crée l’utilisateur
zapx-appsavec des droits sudo. ZapX utilise cet utilisateur pour gérer Coolify et tes applications. La connexion n’est possible qu’avec une clé ZapX et depuis des adresses ZapX. La connexion par mot de passe n’est pas disponible. - Elle installe Coolify avec l’installateur officiel, qui configure également Docker.
- Pour la configuration, ZapX utilise temporairement une clé root aux droits fortement restreints et modifie la configuration SSH si nécessaire. Les deux sont supprimés une fois la configuration terminée.
- La commande ne modifie pas les règles du pare-feu.
Tu trouveras le journal de configuration sur le serveur dans /var/lib/zapx-oneclick-apps/setup.log.
Une fois la configuration terminée, l’onglet One-Click Apps affiche trois sections :
| Section | Contenu |
|---|---|
| Applications installées | Tes applications, leur état et les actions disponibles |
| Catalogue d’applications | Toutes les applications disponibles à l’installation |
| Accès et paramètres | Adresse du panneau, identifiants de connexion et accès de maintenance |
- Ouvre le Catalogue des applications et recherche l’application souhaitée.
- Clique sur Installer.
- Dans la fenêtre Installer l’application, renseigne les valeurs demandées, par exemple
[dein_appname]ou[deine_domain]. - Clique sur Mettre l’installation en file d’attente.
Si ton serveur n’a pas assez de RAM pour une application, le catalogue affiche le message « Ton serveur n’a pas assez de RAM pour cette application. »
Besoin d’aide ? Utilise ZapX AI Agent : dans ZapX AI Agent pour ton serveur, tu peux demander une suggestion d’application, vérifier l’état de tes applications ou préparer une installation. L’agent n’effectue les modifications qu’après ta confirmation. Gère toujours les identifiants et les secrets dans l’onglet One-Click Apps.
Dans Applications installées, tu peux gérer directement chaque application :
| Action | Utilité |
|---|---|
| Démarrer | Démarre une application arrêtée |
| Arrêter | Arrête une application en cours d’exécution |
| Redémarrer | Redémarre l’application |
| Journaux | Affiche les journaux de l’application pour faciliter le dépannage |
| Paramètres | Modifie les variables d’environnement, le domaine et les autres options de l’application |
La carte Accès de maintenance indique si ZapX peut accéder à ton serveur :
| État | Signification |
|---|---|
| Actif | ZapX peut accéder à ton serveur et gérer Coolify et tes applications |
| Interrompu | ZapX ne peut plus accéder à ton serveur, par exemple parce que la clé d’hôte SSH a changé ou que la clé ZapX n’est plus acceptée |
| Supprimé | Tu as supprimé l’accès de maintenance |
Avec Supprimer l’accès, ZapX supprime de ton serveur sa clé, la règle sudo et l’utilisateur zapx-apps. Coolify et tes applications continuent de fonctionner, mais ZapX ne peut plus les gérer : l’installation, le dépannage et les modifications dans le tableau de bord ne sont alors plus possibles. Dans ce cas, tu gères tes applications directement dans le panneau Coolify.
Si ton serveur est inaccessible au moment de la suppression, ZapX désactive l’accès de son côté. Tu peux alors supprimer toi-même l’utilisateur zapx-apps et le fichier /etc/sudoers.d/zapx-apps sur ton serveur.
Avec Rétablir l’accès, tu génères une nouvelle commande qui configure uniquement l’accès de maintenance. Coolify et tes applications restent inchangés. Comme lors de la configuration initiale, exécute la commande sur ton serveur en tant que root.
| Événement | Conséquence |
|---|---|
| Réinstallation depuis l’onglet Installation | La configuration est réinitialisée et les adresses sous zap.cloud sont supprimées. Le système est réinstallé : sauvegarde au préalable les données de tes applications. Configure ensuite à nouveau les applications en un clic. |
| Libération de l’adresse IP du panneau et des applications | L’accès de maintenance est supprimé, les adresses sous zap.cloud sont supprimées et la configuration est réinitialisée. Coolify et tes applications continuent de fonctionner sur le serveur. Pour les gérer à nouveau dans le tableau de bord, configure les applications en un clic avec une autre adresse IP. |
| Résiliation ou fin du contrat | L’accès de maintenance et les adresses sous zap.cloud sont supprimés. |
| Message ou problème | Solution |
|---|---|
| Aucune connexion SSH après quelques minutes | Vérifie que le serveur SSH fonctionne et que ton pare-feu autorise les connexions sur le port SSH |
| Des ports sont déjà utilisés | Arrête les services qui utilisent les ports 8000, 6001, 6002 et 8080, ou réinstalle le serveur |
| Coolify est déjà installé | ZapX ne peut pas prendre en charge une installation de Coolify avec ses propres identifiants de connexion. Supprime-la ou utilise un système vierge |
| Ton serveur SSH n’autorise que certains utilisateurs (AllowUsers) | Ajoute zapx-apps à ta configuration SSH et exécute à nouveau la commande |
| Une installation est en cours sur le serveur | Attends que l’installation dans l’onglet Installation soit terminée |
| Le serveur n’a pas encore d’adresse IPv4 publique | Configure d’abord une adresse IPv4 publique pour ton serveur |
| Trop de tentatives | Attends quelques minutes, puis génère à nouveau la commande |
Tu trouveras plus de détails sur une configuration échouée dans /var/lib/zapx-oneclick-apps/setup.log. Si tu n’arrives pas à résoudre le problème, crée un ticket d’assistance et indique le message d’erreur affiché dans l’onglet.
Source préférée sur Google
