[{"data":1,"prerenderedAt":31},["ShallowReactive",2],{"doc-fr-heberger-application-ruby-plesk":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":21,"docGroup":28,"docGroupIcon":28,"link_en":29,"bodyHtml":30},"\u002Fdocs\u002Ffr\u002Fcloud\u002Fhebergement-web\u002Fheberger-application-ruby-plesk","heberger-application-ruby-plesk","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.","cloud","hebergement-web","tabler:file-text","2026-11-02","Winheberg",153,"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-application-ruby-plesk.webp",[16,17,18,19,20],"Ruby","Plesk","Rack","Passenger","Hébergement Web",[22,23,24,25,26,27],"héberger ruby","ruby plesk","application rack","passenger plesk","bundle install","sinatra hébergement","","\u002Fen\u002Fdocs\u002Fhebergement-web\u002Fhost-ruby-application-plesk","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>Votre \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fcloud\u002Fhebergement-web\">hébergement web Winheberg\u003C\u002Fa> 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.\u003C\u002Fp>\n\u003Cp>L&#39;extension Ruby de Plesk s&#39;occupe de la version de Ruby, de l&#39;installation des gems listées dans votre \u003Ccode>Gemfile\u003C\u002Fcode> et du redémarrage de l&#39;application. Vous n&#39;avez besoin d&#39;aucun accès en ligne de commande.\u003C\u002Fp>\n\u003Cp>Ce guide couvre l&#39;arborescence attendue, le réglage de la racine du site, l&#39;activation de Ruby, l&#39;installation des gems et les erreurs les plus courantes.\u003C\u002Fp>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Un hébergement web Winheberg avec accès au panel Plesk\u003C\u002Fli>\n\u003Cli>Un domaine ou un sous-domaine dédié à l&#39;application, voir notre guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fdocs\u002Fhebergement-web\u002Frelier-domaine-externe-plesk\">Comment relier un domaine externe à votre hébergement Plesk ?\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Votre application, avec son fichier \u003Ccode>config.ru\u003C\u002Fcode> et son \u003Ccode>Gemfile\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>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&#39;ouvre pas, un \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fvps\">VPS Winheberg\u003C\u002Fa> vous donne un contrôle complet du serveur.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Préparer l&#39;arborescence de l&#39;application\u003C\u002Fh2>\n\u003Cp>Plesk attend une organisation précise. Le dossier de l&#39;application contient \u003Ccode>config.ru\u003C\u002Fcode> et le \u003Ccode>Gemfile\u003C\u002Fcode>, et un sous-dossier \u003Ccode>public\u003C\u002Fcode> reçoit les fichiers statiques comme les images ou les feuilles de style.\u003C\u002Fp>\n\u003Cdiv class=\"md-table md-table--info md-table--striped\">\u003Cdiv class=\"md-table__caption\">Arborescence attendue\u003C\u002Fdiv>\u003Cdiv class=\"md-table__scroll\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Élément\u003C\u002Fth>\n\u003Cth>Emplacement\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Dossier de l&#39;application\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>app.exemple.fr\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Fichier de démarrage\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>app.exemple.fr\u002Fconfig.ru\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Liste des gems\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>app.exemple.fr\u002FGemfile\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Fichiers statiques\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>app.exemple.fr\u002Fpublic\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003C\u002Fdiv>\u003Cdiv class=\"md-table__footer\">Exemple pour un sous-domaine app.exemple.fr, dont le dossier porte le même nom.\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Pour tester l&#39;hébergement avant d&#39;envoyer votre vraie application, voici une application minimale. Le fichier \u003Ccode>config.ru\u003C\u002Fcode> contient l&#39;application elle-même.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-ruby\">run lambda { |env|\n  [200, { &quot;content-type&quot; =&gt; &quot;text\u002Fhtml; charset=utf-8&quot; }, [&quot;&lt;h1&gt;Bonjour depuis Ruby #{RUBY_VERSION}&lt;\u002Fh1&gt;&quot;]]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Le fichier \u003Ccode>Gemfile\u003C\u002Fcode> déclare la gem \u003Ccode>rack\u003C\u002Fcode> dont elle a besoin.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-ruby\">source &quot;https:\u002F\u002Frubygems.org&quot;\n\ngem &quot;rack&quot;\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Envoyez ces fichiers dans le dossier de l&#39;application avec le gestionnaire de \u003Cstrong>Fichiers\u003C\u002Fstrong> de Plesk, ou avec notre guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fdocs\u002Fhebergement-web\u002Fconnexion-ftp-filezilla-plesk\">Comment se connecter en FTP à votre hébergement Plesk avec FileZilla ?\u003C\u002Fa>\u003C\u002Fp>\n\u003Ch2>2. Faire pointer le site vers le dossier public\u003C\u002Fh2>\n\u003Cp>Ouvrez votre domaine depuis \u003Cstrong>Sites Web &amp; Domaines\u003C\u002Fstrong>, puis l&#39;onglet \u003Cstrong>Hébergement et DNS\u003C\u002Fstrong> et l&#39;entrée \u003Cstrong>Hébergement\u003C\u002Fstrong>. Dans \u003Cstrong>Racine du document\u003C\u002Fstrong>, ajoutez \u003Ccode>\u002Fpublic\u003C\u002Fcode> au chemin du dossier de l&#39;application, puis cliquez sur \u003Cstrong>Enregistrer\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-application-ruby-plesk-1793618124181-8006fe467e76d8a810cb391a.webp\" alt=\"Racine du document réglée sur le dossier public dans les Paramètres d'hébergement de Plesk\" width=\"615\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Plesk crée alors le dossier \u003Ccode>public\u003C\u002Fcode> s&#39;il n&#39;existe pas, avec sa page par défaut \u003Ccode>index.html\u003C\u002Fcode>. Supprimez ce fichier depuis le gestionnaire de \u003Cstrong>Fichiers\u003C\u002Fstrong>, sinon c&#39;est lui qui s&#39;affiche à l&#39;adresse de votre site, à la place de votre application.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Activer Ruby\u003C\u002Fh2>\n\u003Cp>Dans l&#39;onglet \u003Cstrong>Démarrer\u003C\u002Fstrong> du domaine, cliquez sur \u003Cstrong>Ruby\u003C\u002Fstrong>, puis sur \u003Cstrong>Activer Ruby\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-application-ruby-plesk-1793617797984-d5874d1d15fadbe054572ba9.webp\" alt=\"Onglet Démarrer d'un domaine Plesk avec l'entrée Ruby\" width=\"800\" \u002F>\n\n\u003Cp>La page Ruby affiche alors les réglages de l&#39;application et ses boutons d&#39;action.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-application-ruby-plesk-1793618123859-427210797d3038ce7db989d1.webp\" alt=\"Page Ruby d'un domaine dans Plesk avec Installation de bundle et Redémarrer l'app\" width=\"800\" \u002F>\n\n\u003Cdiv class=\"md-table md-table--info md-table--striped\">\u003Cdiv class=\"md-table__caption\">Réglages de la page Ruby\u003C\u002Fdiv>\u003Cdiv class=\"md-table__scroll\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Réglage\u003C\u002Fth>\n\u003Cth>Ce qu&#39;il indique\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Version de Ruby\u003C\u002Ftd>\n\u003Ctd>La version utilisée par l&#39;application, modifiable en cliquant dessus\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Mode d&#39;application\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>production\u003C\u002Fstrong>, le mode à garder pour un site en ligne\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Root d&#39;application\u003C\u002Ftd>\n\u003Ctd>Le dossier de l&#39;application, toujours le dossier parent de la racine du site\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Variables d&#39;environnement personnalisées\u003C\u002Ftd>\n\u003Ctd>Les variables transmises à l&#39;application, à renseigner avec \u003Cstrong>préciser\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Type d&#39;app Ruby\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Basé sur Rack\u003C\u002Fstrong>, détecté grâce au fichier \u003Ccode>config.ru\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Vérifiez que \u003Cstrong>Root d&#39;application\u003C\u002Fstrong> affiche bien le dossier de votre application, par exemple \u003Ccode>\u002Fapp.exemple.fr\u003C\u002Fcode>. S&#39;il affiche \u003Ccode>\u002F\u003C\u002Fcode>, la racine du site n&#39;a pas été réglée sur le dossier \u003Ccode>public\u003C\u002Fcode>, revenez à l&#39;étape 2.\u003C\u002Fp>\n\u003Ch2>4. Installer les gems\u003C\u002Fh2>\n\u003Cp>Cliquez sur \u003Cstrong>Installation de bundle\u003C\u002Fstrong>. Plesk lit votre \u003Ccode>Gemfile\u003C\u002Fcode>, installe les gems dans le dossier \u003Ccode>vendor\u003C\u002Fcode> de l&#39;application et crée le fichier \u003Ccode>Gemfile.lock\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>Relancez \u003Cstrong>Installation de bundle\u003C\u002Fstrong> à chaque modification du \u003Ccode>Gemfile\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>5. Redémarrer et tester l&#39;application\u003C\u002Fh2>\n\u003Cp>Cliquez sur \u003Cstrong>Redémarrer l&#39;app\u003C\u002Fstrong>, puis ouvrez votre domaine dans un navigateur. L&#39;application minimale affiche la version de Ruby utilisée.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fhebergement-web\u002Fheberger-application-ruby-plesk-1793618124465-922adb9ef4260a9982b42353.webp\" alt=\"Page Bonjour depuis Ruby affichée par l'application de test\" width=\"420\" \u002F>\n\n\u003Cp>Pensez à \u003Cstrong>Redémarrer l&#39;app\u003C\u002Fstrong> après chaque envoi d&#39;une nouvelle version de votre code, Passenger garde sinon l&#39;ancienne en mémoire.\u003C\u002Fp>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Ch3>❌ La page Ruby indique « Fichier de démarrage \u002Fconfig.ru introuvable »\u003C\u002Fh3>\n\u003Cp>Plesk cherche \u003Ccode>config.ru\u003C\u002Fcode> dans le dossier parent de la racine du site, et ne l&#39;y trouve pas.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Vérifiez que la \u003Cstrong>Racine du document\u003C\u002Fstrong> se termine par \u003Ccode>\u002Fpublic\u003C\u002Fcode>, comme à l&#39;étape 2\u003C\u002Fli>\n\u003Cli>Vérifiez que \u003Ccode>config.ru\u003C\u002Fcode> se trouve dans le dossier de l&#39;application, et non dans \u003Ccode>public\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Rechargez la page Ruby, \u003Cstrong>Root d&#39;application\u003C\u002Fstrong> doit afficher le dossier de l&#39;application\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ La page par défaut de Plesk s&#39;affiche à la place de l&#39;application\u003C\u002Fh3>\n\u003Cp>Passenger sert d&#39;abord les fichiers présents dans \u003Ccode>public\u003C\u002Fcode>, dont la page par défaut créée par Plesk.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Supprimez \u003Ccode>public\u002Findex.html\u003C\u002Fcode> depuis le gestionnaire de \u003Cstrong>Fichiers\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Rechargez votre site sans le cache avec Ctrl+F5\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ L&#39;application renvoie une erreur après une mise à jour\u003C\u002Fh3>\n\u003Cp>Une gem manque ou l&#39;application a gardé l&#39;ancienne version en mémoire.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Relancez \u003Cstrong>Installation de bundle\u003C\u002Fstrong>, puis \u003Cstrong>Redémarrer l&#39;app\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Ouvrez le bouton \u003Cstrong>Logs\u003C\u002Fstrong> de la page Ruby pour lire le message d&#39;erreur\u003C\u002Fli>\n\u003Cli>Si l&#39;installation d&#39;une gem échoue à la compilation, ouvrez un ticket auprès de notre support en joignant le message\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Bonnes pratiques\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Gardez le mode \u003Cstrong>production\u003C\u002Fstrong> pour le site public\u003C\u002Fli>\n\u003Cli>Rangez vos clés et mots de passe dans les \u003Cstrong>Variables d&#39;environnement personnalisées\u003C\u002Fstrong>, jamais dans le code\u003C\u002Fli>\n\u003Cli>Versionnez le fichier \u003Ccode>Gemfile.lock\u003C\u002Fcode>, il garantit les mêmes versions de gems en local et sur l&#39;hébergement\u003C\u002Fli>\n\u003Cli>Placez uniquement des fichiers statiques dans \u003Ccode>public\u003C\u002Fcode>, le reste de l&#39;application ne doit pas être accessible depuis le web\u003C\u002Fli>\n\u003Cli>Activez le HTTPS avec notre guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fdocs\u002Fhebergement-web\u002Fcertificat-ssl-lets-encrypt-plesk\">Comment générer un certificat SSL Let&#39;s Encrypt pour votre site web ?\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Besoin d&#39;aide ?\u003C\u002Fh2>\n\u003Cp>Si votre application ne démarre toujours pas, ouvrez un ticket auprès de notre support depuis votre \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">espace client\u003C\u002Fa>, département \u003Cstrong>Technique\u003C\u002Fstrong>, en renseignant le champ \u003Cstrong>Produit lié\u003C\u002Fstrong> avec l&#39;hébergement web concerné. Joignez le contenu des \u003Cstrong>Logs\u003C\u002Fstrong> de la page Ruby et la version de Ruby utilisée.\u003C\u002Fp>\n\u003Cp>Votre application Ruby tourne sur votre hébergement, sans une ligne de commande 💎\u003C\u002Fp>\n",1794526344257]