Directus Déploiement : du démarrage avec Docker à la production
Directus Déploiement : du démarrage avec Docker à la production Un déploiement Directus est facile à démarrer, mais aussi facile à configurer incorrectement de manière subtile. Avec Docker, vous pouvez disposer d’une instance fonctionnelle en quelques minutes.
Directus Déploiement : du démarrage avec Docker à la production
Un déploiement Directus est facile à démarrer, mais aussi facile à configurer incorrectement de manière subtile. Avec Docker, vous pouvez disposer d’une instance fonctionnelle en quelques minutes. Un système de production nécessite une véritable base de données, un stockage de fichiers persistant, le protocole HTTPS, des versions figées, des sauvegardes et une supervision ; chacun de ces éléments doit être pris en charge par une personne de votre équipe. Pour la plupart des organisations, la meilleure approche consiste à traiter le déploiement comme un petit projet d’ingénierie au périmètre défini, et non comme une installation de week-end. Chez Ridiculous Engineering, l’implémentation et la migration de Directus font partie des services que nous proposons, tout comme l’architecture cloud, le DevOps et la CI/CD.
Ce guide présente les options, l’infrastructure nécessaire pour chacune, les étapes dans l’ordre et les points où les déploiements rencontrent généralement des problèmes.
Points clés à retenir
- Directus peut être déployé de trois façons : sur Directus Cloud, en auto-hébergement avec Docker ou à l’aide de guides spécifiques à certaines plateformes pour AWS, Azure, Google Cloud, DigitalOcean, Ubuntu, Railway et Render (Documentation de Directus).
- Le fichier Docker Compose de démarrage officiel n’est explicitement pas prêt pour la production. La production nécessite une base de données externe, un cache, un stockage persistant, le protocole HTTPS et une version d’image figée.
- La plupart des incidents de production proviennent de la même courte liste : des téléchargements non persistants, des balises d’image non figées, des autorisations publiques trop larges et l’absence de sauvegarde testée.
- L’auto-hébergement est disponible avec chaque offre Directus, et les petites organisations éligibles peuvent s’auto-héberger avec une licence complète gratuite.
- Définissez le périmètre du déploiement avant de commencer : qui est responsable de la base de données, des secrets, des mises à niveau et de la réponse d’astreinte.
Table des matières
- Vos trois voies de déploiement
- Ce dont Directus a besoin pour fonctionner
- Étape par étape : un déploiement en production
- Sécuriser un déploiement Directus
- Sauvegardes, supervision et mises à niveau
- Préparer la montée en charge
- Coût de l’auto-hébergement
- Comment nous vous aidons
- FAQ
- Sources
Vos trois voies de déploiement
Directus présente trois options : le service Directus Cloud géré, l’auto-hébergement avec Docker sur un VPS ou votre propre serveur, et des guides étape par étape pour des plateformes spécifiques. Le choix approprié dépend de la personne qui, au sein de votre organisation, prendra en charge les opérations.
| Voie | Vous contrôlez | Vous exploitez | Idéal pour |
|---|---|---|---|
| Directus Cloud | Modèle de contenu, autorisations | Très peu ; l’hébergement, les mises à jour et la mise à l’échelle sont pris en charge pour vous | Les équipes sans ingénieurs spécialisés en plateformes qui souhaitent démarrer rapidement |
| Auto-hébergé avec Docker | Base de données, cache, stockage de fichiers, réseau, région | Tout : mises à niveau, sauvegardes, surveillance, sécurité | Les équipes soumises à des exigences de résidence des données, de conformité ou de maîtrise des coûts |
| Guides des plateformes cloud (AWS, Azure, Google Cloud, DigitalOcean, Railway, Render) | Comme l’auto-hébergement, sur une plateforme que vous utilisez déjà | La majeure partie de la pile, sur des composants gérés | Les organisations déjà standardisées sur un même cloud |
Directus décrit son option Cloud comme entièrement gérée, avec plus de 15 régions dans le monde et une mise à l’échelle automatique. L’auto-hébergement troque cette commodité contre du contrôle. Si votre équipe de sécurité exige que les données restent dans votre propre compte cloud, ou si vous exécutez déjà des conteneurs à grande échelle, l’auto-hébergement est le choix naturel. Si vous n’êtes pas sûr, la première question à trancher n’est pas « Docker ou Cloud ? », mais « qui reçoit l’alerte lorsque la base de données est pleine ? »
Ce dont Directus a besoin pour fonctionner
Avant de choisir votre hébergement, sachez ce que l’application attend. Directus est distribué sous forme d’image Docker, vous avez donc besoin d’un environnement compatible avec Docker. Si vous l’installez plutôt depuis npm, la même page indique une version minimale de Node.js (26 ou ultérieure au moment de la rédaction).
La page des exigences fournit également des recommandations de dimensionnement : au minimum un conteneur avec 0,25 vCPU et 512 Mo, et au minimum deux conteneurs recommandés avec chacun 1 vCPU et 2 Go. Les bases de données prises en charge sont les versions LTS de PostgreSQL, MySQL, SQLite, MS SQL Server, MariaDB, CockroachDB et OracleDB. La même page recommande, sans l’imposer, un système de sauvegarde pour la base de données et le stockage des ressources, un CDN, un répartiteur de charge entre les instances et un système de surveillance.
Pour un responsable qui examine un plan, la liste de contrôle se présente ainsi :
- Base de données : une base de données relationnelle gérée, et non un fichier sur le disque d’un conteneur. PostgreSQL est le choix courant en production.
- Stockage de fichiers : un volume monté ou un stockage d’objets externe, afin que les fichiers importés survivent aux redémarrages.
- Cache : Redis lorsque vous exécutez plusieurs instances ou souhaitez partager le cache.
- Périphérie : un proxy inverse ou un répartiteur de charge qui termine les connexions HTTPS.
- Exploitation : sauvegardes, vérifications d’état, alertes et procédure de mise à niveau documentée.
Ce que Directus fait au cœur de son fonctionnement explique pourquoi la base de données est si importante. Il encapsule votre base de données SQL et génère des API REST et GraphQL à partir du schéma. Votre modèle de données réside dans votre base de données : celle-ci est donc la source de référence du système, et sa protection constitue la tâche principale.
Étape par étape : un déploiement en production
1. Commencez par le modèle officiel, puis abandonnez-le
Le guide de création d’un projet vous fait créer un répertoire directus contenant des sous-répertoires database, uploads et extensions, puis écrire un fichier docker-compose.yml qui exécute l’image Directus sur le port 8055 avec des volumes persistants. Il définit un SECRET, un client de base de données et une URL publique. Le guide lui-même précise que ce modèle n’est pas prêt pour la production. Sa base SQLite est idéale pour un ordinateur portable, mais peu adaptée à un système d’entreprise.
Là où cela dérape : le modèle devient discrètement l’environnement de production. Une preuve de concept est présentée aux parties prenantes, quelqu’un lui associe un domaine, et le contenu de l’entreprise se retrouve alors dans un fichier unique sur un seul serveur. Déterminez rapidement si le premier environnement est jetable ou s’il constitue la base du véritable environnement.
2. Choisissez et provisionnez la base de données
Le Déployer la documentation Directus indique qu’au minimum, vous devez configurer une base de données et définir un SECRET, tous deux au moyen de variables d’environnement. L’exemple Compose de production présenté utilise PostGIS 17-3.5 et Redis 7, PostgreSQL servant de client et Redis de magasin de cache.
Là où cela échoue : exécuter la base de données dans un conteneur sur le même hôte que l’application, sans planification des instantanés. Utilisez autant que possible un service de base de données géré, avec des sauvegardes automatisées et une restauration que vous avez réellement testée.
3. Conserver les fichiers
Les fichiers téléversés ne sont pas stockés dans la base de données. La documentation sur le déploiement de Directus indique que les fichiers sont conservés en montant un volume ou en configurant un stockage externe. Sur Azure, par exemple, le guide officiel monte des partages Azure Files pour les dossiers de la base de données, des extensions et des fichiers téléversés, et exige que le paramètre de stockage de l’application propre à la plateforme reste désactivé. Sur DigitalOcean, le guide App Platform demande une base de données gérée, un droplet Redis pour les instances synchronisées et un stockage d’objets compatible S3 pour les fichiers téléversés.
Là où cela échoue : un nouveau déploiement efface le conteneur, et toutes les images téléversées par votre équipe marketing disparaissent avec lui. Chaque plateforme gère la persistance différemment : vérifiez-la dès le premier jour en téléversant un fichier, puis en recréant le conteneur.
4. Configurer correctement les secrets et un compte administrateur
Générez un SECRET aléatoire et conservez-le dans un gestionnaire de secrets, et non dans un fichier .env versionné dans un dépôt. Pour les déploiements scriptés, Directus indique que vous pouvez préconfigurer l’utilisateur administrateur initial avec les variables ADMIN_* et un jeton d’accès statique. Lorsque vous appliquez des modèles avec l’interface de ligne de commande officielle, la documentation de démarrage de directus-labs recommande le mode interactif afin que le jeton ne se retrouve pas dans l’historique du shell ou dans les listes de processus.
Là où cela échoue : des identifiants présents dans les fils de discussion, les journaux de compilation et les dépôts. Déterminez qui peut lire les secrets de production et comment ils sont renouvelés avant le premier déploiement.
5. Placer HTTPS en amont
Le guide du serveur Ubuntu ouvre les ports de pare-feu 22, 80, 443 et 8055, démarre Directus avec Docker Compose et le rend accessible à l’adresse IP du serveur sur le port 8055 avant l’ajout d’un proxy inverse. Il s’agit d’une étape intermédiaire, pas d’un point d’arrivée. En production, terminez TLS au niveau d’un proxy inverse ou d’un répartiteur de charge, définissez PUBLIC_URL sur l’adresse HTTPS et cessez d’exposer le port 8055 à Internet.
Là où cela échoue : laisser le port brut ouvert ou mélanger des URL HTTP et HTTPS, ce qui interrompt l’application d’administration et les appels d’API depuis votre interface front-end.
6. Épingler la version
La documentation recommande d’épingler l’image Docker sur un tag de version précis en production plutôt que d’utiliser latest, afin qu’un redémarrage n’introduise jamais par surprise des changements incompatibles. Traitez les mises à niveau comme des versions planifiées : lisez les notes de version, sauvegardez la base de données, testez sur une copie de préproduction, puis modifiez le tag.
Là où cela échoue : « latest » dans un fichier Compose. Tout fonctionne pendant des mois, puis un redémarrage de routine modifie le comportement un mardi après-midi.
7. Automatiser le pipeline
Dès qu’il existe plus d’un environnement, les modifications de schéma et les extensions nécessitent un parcours reproductible du développement à la préproduction, puis à la production. C’est là que le CI/CD prend tout son sens : la même compilation, le même modèle de configuration et une restauration que vous pouvez exécuter sous pression. Nous concevons et assurons la maintenance de ce type de pipeline de livraison dans le cadre de nos services de développement logiciel sur mesure .
Sécuriser un déploiement Directus
La sécurité de Directus repose sur deux niveaux : l’infrastructure qui l’entoure et le modèle d’autorisations qui y est intégré.
Infrastructure. Gardez la base de données hors de l’Internet public, n’exposez que le proxy, limitez explicitement les origines autorisées et ne faites confiance aux en-têtes du proxy que lorsqu’un proxy de confiance se trouve effectivement en amont. Gardez les secrets hors du contrôle de version.
Autorisations. Le guide officiel de sécurité est sans détour concernant le rôle Public : il s’applique aux requêtes non authentifiées. Tout ce qui y est autorisé doit donc être considéré comme lisible par le monde entier, et comme modifiable par le monde entier si vous autorisez la création, la mise à jour ou la suppression. Auditez-le avant le lancement, puis après chaque modification du schéma. Il est tout aussi important de savoir qui peut modifier les collections système et les automatisations. Les flux peuvent exécuter une logique avec des privilèges étendus ; l’accès en écriture à ces flux mérite donc le même niveau d’examen que l’accès au serveur. Nous traitons ces deux sujets en détail dans nos guides sur les Directus autorisations, rôles et politiques et les Directus flux en production.
Une question utile à poser aux dirigeants : si le compte d’un éditeur de contenu était compromis demain, quelle serait la pire chose qu’il pourrait faire ? Si la réponse concerne des collections système, renforcez les rôles avant la mise en production.

Sauvegardes, surveillance et mises à niveau
La page des exigences de Directus présente les sauvegardes et la surveillance comme des recommandations. Pour un système métier, considérez-les comme des exigences.
- Sauvegardes : sauvegardez à la fois la base de données et le stockage de fichiers, puis restaurez-les dans un environnement propre selon un calendrier défini. Une sauvegarde que vous n’avez jamais restaurée reste une hypothèse.
- Contrôles d’état : Directus expose deux points de terminaison, conformément à la documentation de déploiement. Le point de terminaison /server/ping ne nécessite pas d’authentification et convient aux sondes des répartiteurs de charge. Le point de terminaison /server/health nécessite une authentification, vérifie la base de données, Redis, le stockage et les e-mails, et renvoie une erreur 503 lorsqu’une dépendance est défaillante.
- Alertes : reliez ces contrôles à une alerte qui atteint une personne désignée ou une équipe d’astreinte, et non une boîte de réception que personne ne surveille.
- Mises à niveau : un court guide opératoire couvrant la sauvegarde, le test en préproduction, la modification du tag, la vérification et le retour arrière. Conservez-le dans le dépôt, à côté du fichier Compose.
C’est la partie qui est négligée après le lancement, car rien ne semble défaillant jusqu’à ce que ce soit le cas. C’est aussi la raison d’être du support à long terme, et notre accompagnement en conseil et en mise en œuvre logicielle couvre l’amélioration continue après la mise en production.
Planifier la montée en charge
Une seule instance est simple. Avec plusieurs instances derrière un répartiteur de charge, les dépendances d’infrastructure apparaissent : Redis partagé pour le cache et la synchronisation, un stockage d’objets partagé afin que chaque instance voie les mêmes fichiers importés, et une base de données unique à laquelle toutes se connectent. Le guide DigitalOcean précise que Directus ne prend actuellement pas en charge Redis en cluster, un détail qu’il vaut mieux connaître avant de concevoir la topologie.

La mise en cache est généralement le premier levier lorsque le trafic augmente. Les équipes venant d’autres plateformes CMS reconnaîtront le principe ; les plugins de mise en cache Drupal reposent sur la même idée : traiter les requêtes répétées sans solliciter l’application à chaque fois. Pour une vue d’ensemble de la préparation de l’infrastructure aux pics de trafic, consultez notre article sur la préparation de l’infrastructure aux événements à fort trafic ; et pour maîtriser la facture à mesure que vous vous développez, consultez notre guide sur la gouvernance des coûts cloud .
Coût de l’auto-hébergement
La licence logicielle et la facture d’infrastructure sont deux questions distinctes. En matière de licences, Directus indique que l’auto-hébergement est disponible à tous les niveaux, et que les organisations dont le chiffre d’affaires annuel est inférieur à 5 M$ et qui comptent moins de 50 employés peuvent bénéficier d’un accès entièrement permissif sans coût logiciel. L’ Open Innovation Grant décrit cette licence gratuite comme n’imposant aucune limite au nombre d’utilisateurs, de collections ou de fonctionnalités pour l’utilisation auto-hébergée. Vérifiez les conditions en vigueur sur ces pages, car elles peuvent changer.
La facture d’infrastructure comprend votre base de données, vos conteneurs, votre stockage, votre bande passante et votre surveillance, ainsi que le temps d’ingénierie nécessaire à leur exploitation. Du côté de l’ingénierie, la comparaison honnête oppose un projet de déploiement ponctuel à l’effort récurrent consacré aux mises à niveau, à l’examen de la sécurité et à la réponse aux incidents.
Comment nous vous aidons
Si vous souhaitez Directus en production sans développer vous-même les compétences opérationnelles nécessaires, nous prenons en charge l’implémentation et la migration, et nous vous accompagnons de la phase de découverte jusqu’au support à long terme. Vous travaillez directement avec des ingénieurs expérimentés. Notre Systèmes de contenu et infrastructure CMS couvre la couche CMS headless, et Consus est notre CMS headless géré, proposé dans le cadre d’une bêta ciblée et d’un processus de consultation. L’étendue et le prix des travaux d’implémentation sont fournis sur demande, en fonction de vos exigences. Pour découvrir plus précisément ce que devrait inclure une mission Directus, consultez notre guide sur le périmètre, le budget et le calendrier d’une mission de conseil Directus, ou notre évaluation honnête de Directus pour déterminer s’il s’agit du choix adapté.
FAQ
Directus est-il gratuit en auto-hébergement ?
L’auto-hébergement est disponible avec chaque niveau de Directus. Les organisations dont le chiffre d’affaires annuel est inférieur à 5 M$ et qui comptent moins de 50 employés peuvent être éligibles à une licence gratuite offrant toutes les fonctionnalités, conformément à la tarification de Directus. Vous devez toutefois payer l’infrastructure et les personnes qui l’exploitent.
Puis-je utiliser Directus uniquement avec Docker Compose ?
Oui pour le développement et les tests locaux. Le fichier Compose de démarrage officiel est présenté comme n’étant pas prêt pour la production ; une configuration de production ajoute donc une base de données externe, Redis, un stockage persistant, HTTPS et une version d’image figée.
Quelle base de données dois-je utiliser en production ?
Directus prend en charge PostgreSQL, MySQL, MariaDB, MS SQL Server, SQLite, CockroachDB et OracleDB. L’ exemple de production dans la documentation utilise PostgreSQL avec Redis. SQLite convient au travail local, mais pas à un système d’entreprise partagé.
Comment savoir si mon instance Directus est opérationnelle ?
Utilisez /server/ping pour de simples vérifications de disponibilité et le point de terminaison authentifié /server/health pour vérifier les dépendances, notamment la base de données, Redis, le stockage et la messagerie électronique. Reliez les deux à votre système d’alerte afin qu’une personne soit rapidement informée en cas de défaillance.
Ai-je besoin d’une équipe pour l’exploiter ?
Quelqu’un doit être responsable des mises à niveau, des sauvegardes, des secrets et de la surveillance. Si ce rôle n’existe pas déjà au sein de votre équipe, il est moins coûteux de le définir avec un partenaire d’ingénierie avant le lancement que de découvrir cette lacune pendant une panne.
Sources
- Comment déployer Directus
- Prérequis pour l’auto-hébergement
- Déployer Directus
- Créer un projet
- Déployer Directus sur un serveur Ubuntu
- Déployer Directus sur Digital Ocean
- Déployer Directus sur Azure Web Apps
- Bonnes pratiques de sécurité
- README des starters de directus-labs
- Directus sur GitHub
- Tarification de Directus
- Commencer avec Directus
- Plugins de mise en cache Drupal