La fonctionnalité Applications en un clic te permet de parcourir un vaste catalogue d’applications et de les déployer directement depuis l’interface Web de ton VPS. Dans ce guide, tu apprendras à préparer ton serveur, à choisir le type d’installation approprié, à installer et à gérer des applications, ainsi qu’à utiliser les paramètres avancés et les outils de dépannage si nécessaire.
Avant d’utiliser les Applications en un clic, ton VPS doit répondre aux exigences minimales et utiliser un système d’exploitation pris en charge.
Configuration minimale requise La fonctionnalité Applications nécessite que ton VPS soit en ligne et configuré avec suffisamment de ressources pour exécuter de manière fiable les services de la plateforme et les applications que tu as installées.
| Exigence | Minimum | Recommandé |
|---|---|---|
| État du serveur | En ligne | En ligne |
| Espace disque | 30 Go | 50 Go |
| RAM | 2 Go | 4 Go |
| CPU | 2 cœurs | 4 cœurs |
| Système d’exploitation | Debian ou Ubuntu LTS | Debian 13 |
Système d’exploitation fraîchement installé recommandé Il est vivement recommandé de configurer la fonctionnalité Applications sur une installation fraîche du système d’exploitation. Tu éviteras ainsi les conflits avec les services existants, les ports déjà utilisés, les configurations Docker ou les paramètres personnalisés présents sur le serveur.
Si tu dois réinstaller ton VPS, utilise une image Debian ou Ubuntu LTS prise en charge et fraîchement installée depuis l’interface de gestion de ton VPS.
Après le déploiement, tes applications installées apparaissent dans la section de gestion de l’onglet. De là, tu peux surveiller et contrôler tes services sans avoir à gérer manuellement les conteneurs sous-jacents.
La section des applications installées te permet d’effectuer directement depuis l’onglet les actions courantes liées au cycle de vie des applications.
| Action | Objectif |
|---|---|
| Démarrer | Démarre une application arrêtée |
| Arrêter | Arrête une application en cours d’exécution |
| Consulter les journaux | Ouvre les journaux de l’application pour le dépannage |
| Réinstaller | Réinstalle l’application |
Ces outils facilitent la gestion de toutes tes applications au même endroit, surtout si tu préfères un contrôle simple via le Web plutôt que d’utiliser manuellement la ligne de commande.
Les projets et les environnements t’aident à structurer clairement tes déploiements. Tu peux les utiliser pour séparer :
- les applications privées et celles de production
- les environnements de test et de production
- les déploiements de plusieurs clients ou équipes
- différents ensembles de services sur le même VPS
Cette organisation devient de plus en plus importante à mesure que ta collection d’applications s’agrandit et que tu gères davantage de services sur un ou plusieurs nœuds.
La fonctionnalité Applications en un clic prend en charge les domaines personnalisés et l’intégration ZAP Cloud. Tu peux ainsi rendre tes applications accessibles de manière sécurisée et fournir des certificats SSL pour tes déploiements.
Prise en charge des domaines et du SSL Tu peux utiliser tes propres domaines pour tes applications et profiter de la mise à disposition automatique de certificats SSL, si la plateforme prend en charge cette configuration.
Lorsque tu attribues un domaine, vérifie que tes enregistrements DNS pointent vers [deine_server_ip]. Si ton domaine n’est pas configuré correctement, l’application risque de ne pas être accessible depuis Internet.
| Valeur | Description |
|---|---|
[deine_domain] | Le domaine ou sous-domaine attribué à ton application |
[deine_server_ip] | L’adresse IP publique de ton VPS |
Le DNS doit pointer vers ton VPS
Si le DNS de [deine_domain] ne pointe pas vers [deine_server_ip], la validation du domaine et l’accès à l’application peuvent échouer.
Si le tableau de bord indique un état dégradé, cela signifie que la plateforme ne parvient pas à joindre l’instance qui exécute la fonctionnalité Applications en un clic ou à récupérer des données. Suis les étapes de dépannage dans l’ordre indiqué.
La fenêtre de dépannage peut afficher les indicateurs suivants :
| État | Signification |
|---|---|
| État de Coolify : actif | Le service du panneau semble fonctionner |
| État de l’API : accessible | L’API est actuellement accessible |
| État du service : en ligne | Ton VPS est en ligne |
Si un ou plusieurs éléments ne fonctionnent pas correctement, passe aux étapes suivantes.
Commence par vérifier que ton VPS est en ligne dans le tableau de bord ZapX. Si le serveur est hors ligne, la plateforme Applications ne peut pas fonctionner.
Utilise l’action Actualiser l’état pour relancer le contrôle d’état avec les données les plus récentes. Cela peut résoudre des problèmes de connexion temporaires.
Problèmes de connexion temporaires Un état dégradé peut parfois être dû à des problèmes de communication passagers. Actualiser l’état est le moyen le plus rapide de commencer les vérifications.
Si l’état reste dégradé, utilise l’action Redémarrer Docker. L’instance de la plateforme redémarre. Une fois l’opération terminée, attends 1-2 minutes, puis actualise à nouveau l’état.
Redémarrage du service Le redémarrage de Docker peut interrompre temporairement les applications en cours d’exécution pendant le redémarrage des services.
En dernier recours, utilise l’action Actualiser les identifiants. Cette étape est particulièrement importante si l’état indique que tout est en ligne, mais que certaines fonctionnalités du tableau de bord, comme l’installation d’applications, ne fonctionnent pas.
Cette action :
- ne supprime pas tes données
- actualise les identifiants de l’utilisateur root
- renouvelle le jeton d’API utilisé par le tableau de bord
- actualise automatiquement les identifiants du panneau si l’opération réussit
Actualisation sécurisée des identifiants L’actualisation des identifiants ne supprime ni les applications installées ni les données de déploiement. Elle renouvelle uniquement les identifiants nécessaires à l’accès et à la communication.
Si le problème persiste après toutes les étapes de dépannage, crée un ticket d’assistance sur le site Web de ZAP-Hosting.
Pour que les Applications en un clic restent stables et faciles à gérer, suis ces recommandations :
| Bonne pratique | Raison |
|---|---|
| Utiliser une nouvelle installation du système d’exploitation | Évite les conflits avec les services existants et les ports utilisés |
| Respecter les ressources recommandées | Améliore les performances et la fiabilité |
| Organiser les applications en projets et environnements | Permet de garder des déploiements clairs |
| Configurer le DNS avant d’attribuer un domaine | Évite les problèmes d’accès et de SSL |
| Utiliser les paramètres avancés avec précaution | Évite les modifications personnalisées non prises en charge |
Organiser tes déploiements
Si tu prévois d’héberger de nombreuses applications, définis un schéma de nommage clair pour [dein_projektname], [dein_umgebungsname] et [dein_appname] avant le premier déploiement.
Source préférée sur Google
