L'assistant d'installation d'applications effectue trois étapes : configurer le compte administrateur et les paramètres du site, vérifier ce qui est sur le point de se produire, puis regarder l'installation s'exécuter et collecter vos identifiants de connexion.
Avant de commencer
Vous avez besoin d'une seule chose : un site web actif sur votre compte. L'assistant installe sur un site que vous avez déjà, il n'en crée pas un. Si vous n'en avez pas, l'assistant vous l'indique et vous lie pour en créer un. Voir Créer votre premier site web.
Vous avez également besoin de la permission apps:write, détenue par les propriétaires de compte et les administrateurs.
Faites une sauvegarde avant d'installer sur un site qui contient déjà du contenu. L'assistant dispose d'un filet de sécurité pour un site qui contient déjà une application, décrit ci-dessous, mais un point de restauration manuel pris délibérément vaut toujours plus qu'un pris automatiquement. Voir Faire une sauvegarde.
Accéder à l'assistant
- Cliquez sur Applications dans la barre latérale de KPanel.
- Cliquez sur l'application que vous souhaitez.
- Cliquez sur Installer [app] dans le panneau de droite.
L'adresse directe est /apps/<app-slug>/install.
Étape 1 : Configurer
L'assistant affiche l'application, puis quatre groupes de champs. Un avis Mise à niveau du plan recommandée apparaît en haut si l'application suggère un niveau de plan plus élevé que celui sur lequel vous êtes : c'est un conseil, et l'installation se poursuit quand même.
Localisation
Installer sur le site. Choisissez parmi vos sites actifs. C'est là que l'application vivra.
Compte administrateur
- Nom d'utilisateur administrateur. Par défaut
admin. C'est le nom d'utilisateur avec lequel vous vous connecterez, et vous pouvez ajouter d'autres utilisateurs plus tard. - Mot de passe administrateur. Un mot de passe fort de 16 caractères est généré pour vous au moment où la page se charge. Afficher le révèle et Générer en crée un nouveau. Vous pouvez aussi saisir le vôtre ; il doit contenir au moins 8 caractères.
- E-mail administrateur. Facultatif. Utilisé pour la connexion et la réinitialisation du mot de passe. Laissé vide, votre e-mail de compte est utilisé.
Enregistrez le mot de passe administrateur avant de quitter l'assistant. Il s'affiche sur l'écran d'examen et à nouveau sur l'écran de succès, puis il disparaît. KapsuleHost ne stocke pas de copie que vous pouvez récupérer ultérieurement, donc le perdre signifie réinitialiser le mot de passe via l'application elle-même.
Paramètres du site
- Nom du site, où l'application le demande.
- Langue. La langue dans laquelle l'application est configurée, choisie parmi seize options incluant English (US), English (UK), Te Reo Māori, et les principales langues européennes et asiatiques. Cela définit la langue de contenu de l'application elle-même, pas celle de KPanel.
Base de données
Affichée uniquement pour les applications qui en ont besoin. L'assistant suggère un nom de base de données dérivé de votre domaine. Lettres et chiffres uniquement, pas de traits de soulignement ni de tirets : le champ l'applique au fur et à mesure que vous tapez. Changez-le si vous le souhaitez.
Les applications qui ont besoin d'une base de données en ont une provisionnée automatiquement dans le cadre de l'installation.
Certaines applications ajoutent leurs propres champs supplémentaires ci-dessous, définis par l'application elle-même, avec du texte d'aide le cas échéant. Les champs obligatoires sont marqués d'un astérisque, et Continuer reste désactivé jusqu'à ce que tous soient remplis.
En bas, l'assistant affiche le résumé des ressources pour cette application : temps d'installation prévu, RAM minimale, et si une base de données est ajoutée.
Cliquez sur Continuer.
Étape 2 : Réviser et confirmer
L'écran de révision réaffirme les décisions dans une liste : application, site web, nom du site, nom d'utilisateur administrateur, mot de passe administrateur (avec un bouton bascule afficher ou masquer), e-mail administrateur, langue et nom de la base de données. Le sous-titre le dit clairement : rien n'est installé jusqu'à ce que vous confirmiez.
- Éditer revient pour changer quelque chose.
- Confirmer et installer démarre le travail.
Utilisez l'écran de révision pour la vérification qui compte le plus : la ligne Site web. L'installation sur le mauvais site est l'erreur d'installation la plus courante, et c'est celle que la protection contre les écrasements ci-dessous existe pour attraper.
Étape 3 : Installer
L'assistant bascule vers une vue de progression. Vous verrez, dans l'ordre :
- En attente : attente du travailleur. Votre travail est dans la file d'attente et commencera bientôt.
- Installation de [app], avec les secondes écoulées par rapport au temps d'installation typique et une barre de progression.
Laissez la page ouverte. L'installation continue en arrière-plan si vous vous éloignez, mais vous perdez la vue en direct et le résumé des identifiants à la fin.
Si l'installation rencontre un problème, elle réessaie automatiquement, en affichant Nouvelle tentative d'installation avec le numéro de tentative. Si elle prend bien au-delà du temps prévu, une note apparaît proposant de continuer à attendre ou d'annuler.
Annulation
Annuler l'installation arrête le travail. L'écran de résultat le confirme : L'installation a été arrêtée. Rien n'a été modifié sur votre site.
Quand le site contient déjà une application
Si le répertoire du site cible contient déjà un site, l'installation s'arrête avec un avertissement nommant ce qu'il a trouvé :
Ce répertoire contient déjà [app]. Installer [new app] va l'ÉCRASER et cela ne peut pas être annulé. Une sauvegarde complète de votre site actuel sera d'abord effectuée afin que vous puissiez la restaurer.
Deux choix : annuler, ou Sauvegarder et écraser. Si vous consentez, le travail prend une sauvegarde complète du site existant avant d'écrire quoi que ce soit, il y a donc un point de restauration.
C'est le point de non-retour dans l'assistant. L'écrasement remplace les fichiers du site existant. La sauvegarde automatique signifie qu'elle est récupérable, pas qu'elle est réversible d'un clic. Si vous n'êtes pas certain que le site est jetable, annulez et installez plutôt sur un site différent.
Applications que notre équipe installe manuellement
Certaines applications n'ont pas d'installateur automatique éprouvé. Pour celles-ci, l'assistant ignore complètement la barre de progression et affiche une confirmation chaleureuse à la place :
Nous configurons [app] pour vous. Cette application nécessite une configuration manuelle, donc notre équipe l'installe sur votre site pour vous après votre commande. Nous vous enverrons un e-mail dès qu'elle sera en direct ; vous n'avez rien d'autre à faire.
Rien n'a échoué et rien n'est en attente de votre part. Les applications sont gratuites, il n'y a donc aucun frais dans un sens ou dans l'autre.
Étape 4 : Vous êtes en direct
En cas de succès, l'assistant affiche [app] est en direct, un lien vers votre domaine, et le résumé des identifiants :
- Nom d'utilisateur administrateur
- Mot de passe administrateur, avec afficher ou masquer
- E-mail administrateur
- Titre du site
Il affiche également le journal d'installation, ligne par ligne, avec chaque étape marquée réussie, échouée ou ignorée. Ce journal vaut la peine d'être examiné même lors d'une installation propre : il vous indique exactement ce qui a été configuré.
Deux boutons terminent le flux : Ouvrir [app] va directement à l'application, et Retour à l'application revient à la page du catalogue.
Que se passe-t-il en cas d'échec
Installation échouée. L'écran de résultat affiche ce qui s'est passé et énonce la partie importante : Tous les modifications partielles ont été annulées. Votre site est propre. Deux actions sont proposées, Réessayer et Contacter le support.
Les causes courantes et ce qu'il faut faire :
- Limites de ressources. Si la RAM minimale de l'application est supérieure à ce que votre plan lui fournit, l'installation peut échouer à mi-chemin. Vérifiez le chiffre RAM minimale sur la page de l'application. Voir Mise à niveau de votre plan.
- Un champ rejeté. L'assistant refuse les entrées contenant des caractères non sûrs pour le shell avant même que le travail soit en file d'attente, et nomme le champ. Simplifiez la valeur : un nom d'utilisateur simple, un mot de passe généré, un nom de base de données avec lettres et chiffres.
- Le site n'est pas actif. Seuls les sites avec le statut ACTIF apparaissent dans la liste déroulante des sites. Un site encore en cours de provisionnement ne sera pas listé.
L'installation a réussi mais le site affiche une erreur. Vérifiez le journal d'installation pour une étape échouée, puis consultez la documentation de l'application pour la configuration post-installation. Les applications communautaires en particulier ont souvent besoin d'exécuter un assistant de configuration final dans le navigateur. Voir Site web non chargé.
Vous avez perdu le mot de passe administrateur. Utilisez la réinitialisation de mot de passe de l'application elle-même avec l'e-mail administrateur que vous avez défini. Pour WordPress spécifiquement, voir Réinitialiser un mot de passe WordPress.
L'installation est coincée sur En attente. La file d'attente des travaux est occupée. Elle commencera. Si elle est toujours en attente longtemps après le temps d'installation prévu, annulez-la et réessayez, puis ouvrez un ticket de support si cela se répète.