Déployer une application Python (Django ou Flask) sur cPanel
Avant de commencer
Si vous avez une application Python, que ce soit un projet Django ou une API Flask, vous pouvez la déployer directement sur votre hébergement cPanel KennHosting. Vous n'avez pas besoin d'un serveur dédié ni d'un VPS pour ça : cPanel intègre un outil natif, "Setup Python App", qui s'appuie sur Passenger pour faire tourner votre application Python aux côtés de votre site.
Ce guide couvre la création de l'application dans cPanel, l'installation de vos dépendances, la configuration du point d'entrée WSGI (le fichier qui relie votre code à Passenger), la connexion à une base de données, et les particularités propres à Django et à Flask.
Étape 1 : créer l'application dans cPanel
Connectez-vous à votre cPanel, puis rendez-vous dans la section Logiciels. Cliquez sur Setup Python App (parfois affiché "Configurer une application Python" selon la langue de l'interface).
Cliquez ensuite sur Create Application. Un formulaire vous demande plusieurs informations :
- Version Python : choisissez une version récente dans la liste proposée (Python 3.10 ou 3.11 par exemple, selon ce qui est disponible sur votre compte).
- Application root : le dossier qui contiendra votre code, par exemple
monapi. Ce dossier se trouve à la racine de votre compte (pas danspublic_htmldirectement, Passenger gère lui-même l'exposition de l'application). - Application URL : le domaine, sous-domaine ou sous-dossier sur lequel votre application sera accessible.
- Application startup file : cPanel propose par défaut
passenger_wsgi.py. C'est le fichier que Passenger va charger pour démarrer votre application, et un squelette minimal est généré automatiquement à la création. Nous allons le modifier à l'étape 5.
Validez la création. cPanel crée le dossier, un environnement virtuel Python dédié (virtualenv) et le fichier passenger_wsgi.py de départ.
Étape 2 : noter la commande d'activation du virtualenv
Une fois l'application créée, cPanel affiche en haut de la page une commande d'activation de l'environnement virtuel, propre à votre compte. Elle ressemble à ceci, mais avec votre propre nom d'utilisateur et le chemin exact de votre application :
source /home/votrecompte/virtualenv/monapi/3.11/bin/activate && cd /home/votrecompte/monapi
Copiez exactement cette commande depuis l'interface cPanel, ne la recopiez pas de mémoire : le chemin varie selon votre compte, le nom de votre application et la version Python choisie. Vous en aurez besoin à chaque fois que vous voudrez installer une dépendance ou lancer une commande Django depuis le Terminal.
Étape 3 : envoyer le code de votre application
Vous avez deux façons de mettre votre code sur le serveur :
Avec Git (recommandé si vous êtes à l'aise en SSH) : connectez-vous en SSH à votre compte (depuis l'onglet Terminal de cPanel ou un client SSH), placez-vous dans le dossier "Application root" créé à l'étape 1, puis clonez votre dépôt :
cd /home/votrecompte/monapi
git clone https://github.com/votre-compte/votre-projet.git .
Avec le Gestionnaire de fichiers ou FTP : compressez votre projet en .zip (sans l'environnement virtuel local si vous en avez un), uploadez l'archive dans le dossier "Application root" via le Gestionnaire de fichiers de cPanel, puis clic droit sur l'archive pour choisir Extraire.
Dans les deux cas, n'incluez pas de dossier venv/ ou .venv/ local : l'environnement virtuel sera celui que cPanel a généré à l'étape 1, vous y installerez les dépendances à l'étape suivante.
Étape 4 : installer les dépendances
Ouvrez le Terminal depuis cPanel (section Avancé), activez le virtualenv avec la commande notée à l'étape 2, puis installez les paquets listés dans votre fichier requirements.txt :
source /home/votrecompte/virtualenv/monapi/3.11/bin/activate && cd /home/votrecompte/monapi
pip install -r requirements.txt
Si votre projet n'a pas encore de requirements.txt, générez-le depuis votre environnement de développement avant l'upload :
pip freeze > requirements.txt
Étape 5 : configurer le point d'entrée passenger_wsgi.py
C'est l'étape la plus importante et la plus souvent source d'erreur. Passenger charge le fichier passenger_wsgi.py et s'attend à y trouver une variable nommée exactement application. Le contenu de ce fichier change selon votre framework.
Pour une application Flask
Si votre fichier principal s'appelle monapp.py et que votre instance Flask s'appelle app à l'intérieur, votre passenger_wsgi.py doit ressembler à ceci :
import sys
import os
sys.path.insert(0, os.path.dirname(__file__))
from monapp import app as application
Le nom application est obligatoire, ce n'est pas un choix arbitraire : c'est ce que Passenger recherche pour savoir comment démarrer votre app. Si votre instance Flask s'appelle autrement dans votre code, adaptez uniquement la partie import ... as application, pas le nom final.
Pour une application Django
Django génère déjà un fichier wsgi.py à l'intérieur du dossier de votre projet (celui créé par django-admin startproject monprojet, vous le trouverez dans monprojet/wsgi.py). Votre passenger_wsgi.py doit simplement pointer vers ce wrapper existant :
import sys
import os
sys.path.insert(0, os.path.dirname(__file__))
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'monprojet.settings')
from monprojet.wsgi import application
Remplacez monprojet par le nom réel de votre dossier de projet Django (celui qui contient settings.py, urls.py, wsgi.py). Si votre application ne démarre pas après cette étape, le premier réflexe est de vérifier que ce nom correspond exactement à l'arborescence envoyée sur le serveur.
Étape 6 : définir les variables d'environnement
Plutôt que d'écrire vos secrets en clair dans le code, utilisez la section Environment Variables de l'interface "Setup Python App". Ajoutez-y par exemple :
SECRET_KEY=votre_cle_secrete_django_ou_flask
DEBUG=False
DB_HOST=localhost
DB_NAME=votrecompte_nomdebase
DB_USER=votrecompte_utilisateur
DB_PASSWORD=votre_mot_de_passe
Ces variables sont injectées automatiquement par Passenger dans l'environnement de votre application, vous pouvez les lire dans votre code Python avec os.environ.get('SECRET_KEY').
Étape 7 : préparer la base de données
Avant de connecter votre application, créez la base de données MySQL (ou PostgreSQL, les deux moteurs sont disponibles) directement depuis cPanel. Si vous n'avez pas encore créé de base sur votre compte, suivez notre article dédié à la création d'une base de données MySQL dans cPanel, les étapes sont les mêmes quel que soit le langage utilisé ensuite pour s'y connecter.
Pensez à ajouter le bon connecteur à votre requirements.txt selon le moteur choisi :
# Pour MySQL
mysqlclient
# Pour PostgreSQL
psycopg2-binary
Réinstallez ensuite les dépendances (pip install -r requirements.txt, virtualenv activé) si vous avez ajouté une ligne après l'étape 4.
Étape 8 : commandes spécifiques à Django
Si vous déployez un projet Django, deux commandes sont à lancer depuis le Terminal, virtualenv activé, avant de considérer le déploiement terminé :
python manage.py migrate
python manage.py collectstatic
La commande migrate applique vos migrations de base de données sur la base que vous venez de connecter. La commande collectstatic regroupe tous vos fichiers statiques (CSS, JS, images de l'admin) dans un seul dossier, défini par le réglage STATIC_ROOT de votre settings.py. Sur un hébergement mutualisé, Django ne sert pas ces fichiers statiques lui-même en production : assurez-vous que STATIC_ROOT pointe vers un dossier accessible, et que votre configuration (ou un lien symbolique) le rend joignable depuis le web si vous en avez besoin publiquement.
Étape 9 : démarrer l'application
Retournez dans Setup Python App, repérez votre application dans la liste, et cliquez sur Restart. C'est ce bouton qui recharge réellement votre code : toute modification de fichier ou de dépendance ne sera prise en compte qu'après ce redémarrage.
Visitez ensuite l'URL configurée à l'étape 1 pour vérifier que tout fonctionne.
Mettre à jour votre application plus tard
Un point important à garder en tête : ce déploiement manuel ne se met pas à jour automatiquement à chaque git push sur votre dépôt. Il n'y a pas de webhook intégré dans cette configuration. Pour publier une nouvelle version de votre code, vous devrez :
- Mettre à jour les fichiers sur le serveur (
git pullsi vous avez cloné en SSH, ou re-upload via le Gestionnaire de fichiers). - Réinstaller les dépendances si
requirements.txta changé (pip install -r requirements.txt, virtualenv activé). - Relancer les migrations si besoin (
python manage.py migratepour Django). - Cliquer sur Restart dans Setup Python App.
Si vous développez activement et que vous préférez un déploiement automatique à chaque push sans repasser par ces étapes manuellement, notre module Applications (accessible depuis votre espace client) propose justement ce fonctionnement avec une app déjà connectée à votre dépôt GitHub.
Articles liés
Déployer une API Node.js/Express sur cPanel
Guide complet pour déployer une API Node.js/Express sur votre hébergement cPanel, avec l'outil Setup Node.js App : création de l'application, installation des dépendances, variables d'environnement et redémarrage.
Déployer une application Laravel ou Symfony sur cPanel
Laravel et Symfony ont tous les deux un dossier public/ qui doit devenir la racine servie par le serveur. Voici comment bien le configurer sur votre hébergement cPanel, étape par étape.
Déployer une application React sur cPanel
Build statique, upload dans public_html, routage côté client avec .htaccess : le guide complet pour mettre votre application React en ligne sur votre hébergement cPanel.
Déployer React + Express.js + MySQL sur cPanel (Guide Complet)
Guide complet pour déployer une application React, Express.js et MySQL sur cPanel.
