Déployer une application du catalogue sur un serveur dédié

Objectif

Le catalogue applicatif vous permet d'installer une application prête à l'emploi sur votre serveur dédié OVHcloud, sans connaissances préalables en administration système. Vous choisissez une application lors de la (ré)installation de votre serveur, puis vous complétez un court formulaire de configuration dans une interface web sécurisée. L'application est installée nativement sur le serveur, sécurisée en HTTPS et disponible en quelques minutes.

Ce guide vous explique comment utiliser le catalogue applicatif sur votre serveur dédié OVHcloud.

Prérequis

• Disposer d'un serveur dédié dans votre compte OVHcloud
• Être connecté à votre espace client OVHcloud
• Disposer d'un accès à l'API OVHcloud (pour la section « API OVHcloud » de ce guide)
• Avoir accès à l'adresse e-mail de votre compte OVHcloud, afin de recevoir le lien vers l'interface de configuration
• Disposer d'un navigateur web pour accéder à l'interface de configuration une fois l'installation terminée

Accès à l'espace client OVHcloud

• Lien direct : Serveurs dédiés
• Pour accéder à vos services : Bare Metal Cloud > Serveurs dédiés > Sélectionnez votre serveur

En pratique

Fonctionnement du catalogue applicatif

Le déploiement d'une application se déroule en deux étapes :

1. Sélection (à l'installation) : vous (ré)installez votre serveur avec une image du catalogue applicatif et vous sélectionnez une seule application. C'est ici que vous choisissez quelle application vous souhaitez déployer.
2. Configuration (après le premier démarrage) : une fois le serveur redémarré, un configurateur à usage unique se lance automatiquement et met à disposition une interface web sécurisée sur le port 10143. Vous complétez un court formulaire (par exemple un nom de site et un mot de passe administrateur), puis l'application est installée automatiquement et publiée en HTTPS.

Une fois l'installation réussie, le configurateur se supprime entièrement du serveur : son binaire, son service et ses données de travail sont effacés. Il ne reste alors que votre application, et vous disposez d'un accès root complet au serveur.

Les applications sont installées nativement — avec des paquets système et des services systemd, sur un serveur dédié à ce seul usage — et non au sein d'une plateforme de conteneurs.

Limites techniques :

• Une seule application est déployable grâce au catalogue applicatif.
• Le partitionnement personnalisé et la configuration du RAID matériel ne sont pas disponibles pour cette installation.

Applications disponibles

Le catalogue est régulièrement mis à jour : lors du lancement d'une installation, référez-vous à la liste affichée dans l'espace client OVHcloud. Les applications suivantes sont disponibles :

Sélectionner votre application à l'installation

Deux méthodes de déploiement sont disponibles, décrites dans les onglets ci-dessous : installez votre application depuis l'espace client OVHcloud, ou utilisez l'API OVHcloud pour intégrer l'installation à vos propres scripts et automatiser vos déploiements.

{
  "operatingSystem": "ubuntu2404-withapp",
  "customizations": {
    "hostname": "myApplicationServer",
    "sshKey": "mySshKey",
    "appToInstall": "wordpress"
  }
}

Configurer votre application et y accéder

Après l'installation, votre serveur démarre automatiquement le configurateur à usage unique. Cette étape ne nécessite aucune compétence Linux, SSH ou d'administration système : un navigateur web suffit.

Étape 1 : ouvrir le configurateur

Une fois l'installation terminée, vous recevez un e-mail contenant le lien vers votre configurateur. Il se présente sous la forme suivante :

https://<votre-serveur>:10143/static/deploy.html?app=<application>&token=<jeton>

Ouvrez ce lien dans votre navigateur web. Le jeton qu'il contient vous authentifie et un cookie de session sécurisé est enregistré : vous pouvez ensuite naviguer dans le configurateur sans le jeton dans la barre d'adresse. Ouvrir le configurateur sans jeton valide affiche une page Unauthorized.

Étape 2 : compléter le formulaire de configuration

Le configurateur s'ouvre directement sur l'application que vous avez sélectionnée à l'installation. Selon cette application, vous déployez immédiatement ou vous complétez d'abord un court formulaire :

• Les applications sans champ — Coolify, Dokploy, Easypanel, FastPanel, HestiaCP, Discourse, Matomo et n8n — génèrent elles-mêmes les identifiants nécessaires et les affichent à la fin. Cliquez sur Deploy.
• Les applications avec champs — WordPress, Drupal, Nextcloud, PrestaShop, OpenClaw et OVHcloud Game Panel — demandent quelques valeurs, comme un nom de site, un mot de passe administrateur ou un mot de passe de base de données. Les champs obligatoires sont signalés et les champs facultatifs peuvent proposer des valeurs par défaut.

Un panneau Installation details, situé au-dessus du formulaire, détaille ce qui va être installé et pourquoi, avec un lien vers la documentation officielle de l'éditeur.

Chaque champ est validé avant le lancement du déploiement (par exemple, un champ e-mail doit contenir une adresse valide et les mots de passe ont une longueur minimale). Corrigez les champs signalés, puis validez à nouveau.

Cliquez ensuite sur Deploy.

Étape 3 : suivre le déploiement

Le configurateur exécute l'installation et en diffuse la progression en temps réel : un statut (pending, puis running, puis completed ou failed), une barre de progression et les journaux d'installation. Les valeurs que vous avez saisies dans le formulaire sont masquées dans les journaux.

Un déploiement prend généralement quelques minutes ; les applications plus lourdes, comme Discourse, prennent plus de temps. Vous pouvez laisser l'onglet ouvert, mais l'installation se poursuit sur le serveur même si votre navigateur se déconnecte : rouvrez votre lien pour reprendre le suivi.

Étape 4 : récupérer vos informations d'accès

Lorsque le statut atteint completed, le configurateur affiche une page de succès comportant :

• le lien vers votre application, sur le port HTTPS standard — https://<votre-serveur>/ ;
• les identifiants ou informations générés par l'application, par exemple un nom d'utilisateur administrateur, un nom de base de données ou un mot de passe généré.

Un certificat Let's Encrypt gratuit et renouvelé automatiquement est émis pour le nom d'hôte de votre serveur pendant l'installation, et l'application déployée en gère elle-même le renouvellement.

Étape 5 : le configurateur se supprime

Peu après un déploiement réussi, le configurateur supprime son propre binaire, son service et ses données de travail. À partir de ce moment :

• l'interface du configurateur sur le port 10143 ne répond plus — c'est le comportement attendu, et non un échec ;
• votre application, ses données et son certificat HTTPS sont conservés ;
• votre serveur n'exécute que votre application, sans outil d'installation ni interface d'administration résiduelle.

Vous disposez de la pleine maîtrise du serveur, y compris d'un accès root en SSH si vous avez ajouté une clé lors de l'installation. Le configurateur ne gère plus rien au-delà de cette étape.

Pour déployer une autre application, réinstallez votre serveur depuis le catalogue applicatif et sélectionnez la nouvelle application.

Résolution des problèmes courants

Aller plus loin

Installer un OS via l'API OVHcloud sur un serveur dédié

Comprendre le processus de démarrage des serveurs dédiés

Activer et configurer le Edge Network Firewall

Échangez avec notre communauté d'utilisateurs.