Avant de commencer

Prérequis

Sites Conformes est basé sur Django/Wagtail et nécessite :

• Python 3.12 à 3.14

• PostgreSQL 14 à 17

• Un espace de stockage pour les fichiers médias (local ou object storage S3)

• un serveur web WSGI ou ASGI, par exemple Gunicorn + Nginx (Scalingo prend automatiquement en charge cet aspect)

• un nom de domaine (pas forcément nécessaire au moment du déploiement initial, cela peut être changé à tout moment).

Le dépôt et les branches

Le dépôt GitHub présentant la version officielle de Sites Conformes est https://github.com/numerique-gouv/sites-conformes

La branche main correspond à la branche contenant les développements récents.

La branche production est la branche à déployer sur les instances. Elle est mise à jour à chaque release.

Les releases sont à suivre ici.

Les niveaux

Chaque méthode de déploiement porte un badge indiquant le niveau technique attendu. Ce n’est pas une note d’intelligence : c’est une estimation du temps et des compétences système nécessaires.

Badge	Niveau	Pour qui ?
🟢 Débutant	Pas (ou peu) d’administration système. On suit les étapes, l’hébergeur s’occupe du reste.	Agent, webmestre, développeur·se peu familier·e des serveurs Linux.
🔵 Confirmé	À l’aise avec la ligne de commande Linux, les services système, les bases de données.	Développeur·se ou administrateur·rice système.

Deux outils que vous croiserez partout

• uv est un gestionnaire de paquets et d’environnements Python (un remplaçant rapide de pip + venv). C’est l’outil utilisé par le projet. Quand vous voyez uv sync, cela installe les dépendances décrites dans le fichier pyproject.toml / uv.lock, l’équivalent moderne de pip install -r requirements.txt.

• just est un lanceur de commandes (un « raccourcisseur »). Le projet fournit un fichier justfile qui regroupe des recettes prêtes à l’emploi. Au lieu de taper une longue suite de commandes Django, vous tapez par exemple just deploy. Pour voir toutes les recettes disponibles : just.