Hébergement Web

Comment héberger une application Ruby sur Plesk ?

Hébergez une application Ruby basée sur Rack sur l'hébergement web Plesk Winheberg, arborescence, racine public, activation de Ruby, installation des gems, redémarrage et dépannage.

2 novembre 2026 Winheberg
Documentation›Hébergement Web›Comment héberger une application Ruby sur Plesk ?

Contexte

Votre hébergement web Winheberg peut faire tourner des applications Ruby basées sur Rack, comme celles écrites avec Sinatra, Roda ou Hanami. Plesk les sert avec Phusion Passenger, qui démarre votre application à la première visite et la garde en mémoire.

L'extension Ruby de Plesk s'occupe de la version de Ruby, de l'installation des gems listées dans votre Gemfile et du redémarrage de l'application. Vous n'avez besoin d'aucun accès en ligne de commande.

Ce guide couvre l'arborescence attendue, le réglage de la racine du site, l'activation de Ruby, l'installation des gems et les erreurs les plus courantes.

Prérequis

Une application qui a besoin de lancer des commandes en ligne de commande, comme les migrations de Ruby on Rails, demande un accès SSH. Si votre offre ne l'ouvre pas, un VPS Winheberg vous donne un contrôle complet du serveur.

1. Préparer l'arborescence de l'application

Plesk attend une organisation précise. Le dossier de l'application contient config.ru et le Gemfile, et un sous-dossier public reçoit les fichiers statiques comme les images ou les feuilles de style.

Arborescence attendue
Élément Emplacement
Dossier de l'application app.exemple.fr
Fichier de démarrage app.exemple.fr/config.ru
Liste des gems app.exemple.fr/Gemfile
Fichiers statiques app.exemple.fr/public

Pour tester l'hébergement avant d'envoyer votre vraie application, voici une application minimale. Le fichier config.ru contient l'application elle-même.

run lambda { |env|
  [200, { "content-type" => "text/html; charset=utf-8" }, ["<h1>Bonjour depuis Ruby #{RUBY_VERSION}</h1>"]]
}

Le fichier Gemfile déclare la gem rack dont elle a besoin.

source "https://rubygems.org"

gem "rack"

Envoyez ces fichiers dans le dossier de l'application avec le gestionnaire de Fichiers de Plesk, ou avec notre guide Comment se connecter en FTP à votre hébergement Plesk avec FileZilla ?

2. Faire pointer le site vers le dossier public

Ouvrez votre domaine depuis Sites Web & Domaines, puis l'onglet Hébergement et DNS et l'entrée Hébergement. Dans Racine du document, ajoutez /public au chemin du dossier de l'application, puis cliquez sur Enregistrer.

Racine du document réglée sur le dossier public dans les Paramètres d'hébergement de Plesk

Plesk crée alors le dossier public s'il n'existe pas, avec sa page par défaut index.html. Supprimez ce fichier depuis le gestionnaire de Fichiers, sinon c'est lui qui s'affiche à l'adresse de votre site, à la place de votre application.

3. Activer Ruby

Dans l'onglet Démarrer du domaine, cliquez sur Ruby, puis sur Activer Ruby.

Onglet Démarrer d'un domaine Plesk avec l'entrée Ruby

La page Ruby affiche alors les réglages de l'application et ses boutons d'action.

Page Ruby d'un domaine dans Plesk avec Installation de bundle et Redémarrer l'app
Réglages de la page Ruby
Réglage Ce qu'il indique
Version de Ruby La version utilisée par l'application, modifiable en cliquant dessus
Mode d'application production, le mode à garder pour un site en ligne
Root d'application Le dossier de l'application, toujours le dossier parent de la racine du site
Variables d'environnement personnalisées Les variables transmises à l'application, à renseigner avec préciser
Type d'app Ruby Basé sur Rack, détecté grâce au fichier config.ru

Vérifiez que Root d'application affiche bien le dossier de votre application, par exemple /app.exemple.fr. S'il affiche /, la racine du site n'a pas été réglée sur le dossier public, revenez à l'étape 2.

4. Installer les gems

Cliquez sur Installation de bundle. Plesk lit votre Gemfile, installe les gems dans le dossier vendor de l'application et crée le fichier Gemfile.lock.

Relancez Installation de bundle à chaque modification du Gemfile.

5. Redémarrer et tester l'application

Cliquez sur Redémarrer l'app, puis ouvrez votre domaine dans un navigateur. L'application minimale affiche la version de Ruby utilisée.

Page Bonjour depuis Ruby affichée par l'application de test

Pensez à Redémarrer l'app après chaque envoi d'une nouvelle version de votre code, Passenger garde sinon l'ancienne en mémoire.

En cas de problème

❌ La page Ruby indique « Fichier de démarrage /config.ru introuvable »

Plesk cherche config.ru dans le dossier parent de la racine du site, et ne l'y trouve pas.

  • Vérifiez que la Racine du document se termine par /public, comme à l'étape 2
  • Vérifiez que config.ru se trouve dans le dossier de l'application, et non dans public
  • Rechargez la page Ruby, Root d'application doit afficher le dossier de l'application

❌ La page par défaut de Plesk s'affiche à la place de l'application

Passenger sert d'abord les fichiers présents dans public, dont la page par défaut créée par Plesk.

  • Supprimez public/index.html depuis le gestionnaire de Fichiers
  • Rechargez votre site sans le cache avec Ctrl+F5

❌ L'application renvoie une erreur après une mise à jour

Une gem manque ou l'application a gardé l'ancienne version en mémoire.

  • Relancez Installation de bundle, puis Redémarrer l'app
  • Ouvrez le bouton Logs de la page Ruby pour lire le message d'erreur
  • Si l'installation d'une gem échoue à la compilation, ouvrez un ticket auprès de notre support en joignant le message

Bonnes pratiques

  • Gardez le mode production pour le site public
  • Rangez vos clés et mots de passe dans les Variables d'environnement personnalisées, jamais dans le code
  • Versionnez le fichier Gemfile.lock, il garantit les mêmes versions de gems en local et sur l'hébergement
  • Placez uniquement des fichiers statiques dans public, le reste de l'application ne doit pas être accessible depuis le web
  • Activez le HTTPS avec notre guide Comment générer un certificat SSL Let's Encrypt pour votre site web ?

Besoin d'aide ?

Si votre application ne démarre toujours pas, ouvrez un ticket auprès de notre support depuis votre espace client, département Technique, en renseignant le champ Produit lié avec l'hébergement web concerné. Joignez le contenu des Logs de la page Ruby et la version de Ruby utilisée.

Votre application Ruby tourne sur votre hébergement, sans une ligne de commande 💎

Besoin d'un serveur Hébergement Web ?

Découvrez nos offres adaptées à vos besoins et lancez-vous dès maintenant.

Voir les offres