Guide Directus CMS : Le CMS Headless Database-First pour Développeurs

La plupart des CMS headless vous demandent de construire votre modèle de données dans leur propre système. Directus fait l'inverse — il enveloppe votre base de données SQL existante et vous fournit des API REST et GraphQL instantanées sans toucher à votre schéma. Avec environ 34 500 étoiles GitHub et une adoption par des entreprises comme Tripadvisor, Adobe et Mercedes-Benz, c'est l'une des options open source les plus complètes parmi les meilleurs CMS headless en 2026.

Qu'est-ce que Directus CMS ?

Directus est un CMS headless open source qui enveloppe n'importe quelle base de données SQL existante avec des API REST et GraphQL instantanées. Contrairement à Strapi ou Payload, Directus ne crée pas son propre schéma de base de données — il reflète le vôtre. Il supporte 7 bases de données, dont PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB et MS-SQL, et est gratuit pour les organisations dont les revenus sont inférieurs à 5 M$ selon la documentation officielle de Directus.

Imaginez-le comme une couche intelligente posée au-dessus de votre base de données. Vous apportez une base PostgreSQL existante avec 50 tables, vous la connectez à Directus, et en quelques minutes vous disposez d'une interface d'administration complète, d'un contrôle d'accès basé sur les rôles, ainsi que d'endpoints REST et GraphQL. Aucun script de migration. Aucune restructuration des données.

C'est ce que signifie concrètement « database-first », et c'est fondamentalement différent de l'approche code-first de Strapi (où vous définissez des types de contenu qui génèrent des tables) ou de l'approche framework intégré de Payload CMS (où le CMS vit à l'intérieur de votre application Next.js).

L'architecture database-first expliquée

Quand nous avons connecté Directus pour la première fois à une base PostgreSQL existante pour un projet client, ce qui nous a surpris, c'était la quantité infime de configuration nécessaire. Directus inspecte votre schéma de base de données — les tables deviennent des « collections », les colonnes deviennent des « champs » — et construit son interface d'administration à partir de ce qui existe déjà.

Cela signifie que vos données ne sont jamais enfermées dans un format propriétaire. Si vous décidez demain d'abandonner Directus, votre base de données reste une base SQL standard. Essayez de faire ça avec Contentful ou Sanity, où votre contenu vit sur leurs serveurs dans leur propre format.

Directus n'est pas non plus qu'un simple CMS. L'équipe le positionne comme une plateforme de données composable — les équipes l'utilisent pour du BaaS (Backend as a Service), des panneaux d'administration internes et des tableaux de bord personnalisés. Le cas d'usage CMS est le plus courant, mais l'architecture supporte bien davantage.

Fonctionnalités clés de Directus

Directus propose des API REST et GraphQL doubles, des permissions granulaires basées sur les rôles, une automatisation Flows intégrée, un Data Studio en glisser-déposer, la gestion des ressources numériques et la prise en charge native de l'i18n pour plus de 50 langues. Depuis la v11.15, il inclut l'édition collaborative et un Assistant IA comme fonctionnalités natives — pas des plugins tiers.

Voici ce qui compte le plus si vous évaluez Directus pour un projet :

API REST et GraphQL doubles

Les deux API sont disponibles simultanément depuis les mêmes données, sans aucune configuration. Vous n'en choisissez pas une plutôt que l'autre — vous obtenez les deux. Votre équipe mobile peut utiliser REST pendant que votre frontend web utilise GraphQL. L'API REST suit un pattern prévisible (/items/{collection}) et l'endpoint GraphQL se trouve à /graphql.

Flows et automatisation

Les Flows sont le système d'automatisation événementielle de Directus, intégré directement dans l'interface du Data Studio. Vous pouvez déclencher des workflows sur des événements CRUD (élément créé, mis à jour, supprimé), des planifications (style cron) ou des webhooks. Les opérations comprennent l'envoi d'e-mails, les requêtes HTTP, l'exécution de JavaScript personnalisé et la transformation de données.

Pour les équipes qui travaillent avec l'IA, Directus dispose même d'un serveur Model Context Protocol (MCP) natif — nous y reviendrons dans la section v11.

Extensions et personnalisation

Le système d'extensions prend en charge les hooks (gestionnaires d'événements côté serveur), les endpoints personnalisés, les panneaux UI, les modules complets et les nœuds d'opération pour les Flows. Les extensions sont développées avec Vue.js pour le frontend et Node.js pur pour le backend. La version v11.0 a restructuré les extensions d'un format basé sur les types vers un format bundlé plus propre.

Voici comment Directus se compare à la concurrence en termes de fonctionnalités :

Quoi de neuf dans Directus v11 (2025-2026) ?

Directus v11 a introduit la prise en charge native du serveur MCP (v11.13), un Assistant IA supportant OpenAI, Anthropic et Gemini (v11.14), l'édition collaborative avec indicateurs de présence en direct (v11.15) et des versions de brouillon globales avec des permissions de déploiement basées sur les rôles (v11.16). Ce sont toutes des fonctionnalités intégrées, pas des extensions de la communauté.

C'est là que Directus a évolué le plus vite, et c'est la section que la plupart des concurrents ratent complètement. Un seul des six principaux guides en ligne couvre ces éléments.

Serveur MCP et Assistant IA

La version v11.13 a fait de Directus l'un des premiers CMS avec un serveur MCP natif. Si vous utilisez Claude, ChatGPT ou n'importe quel outil IA compatible MCP, il peut gérer votre contenu Directus directement — lire des collections, créer des éléments, mettre à jour des champs — tout en respectant vos permissions RBAC. Si vous découvrez MCP, notre guide Model Context Protocol (MCP) explique le protocole en détail.

L'Assistant IA (v11.14) est distinct du MCP — c'est une interface de chat intégrée dans le Data Studio qui supporte OpenAI, Anthropic, Gemini et même les modèles locaux via Ollama. Avec la v11.16, il est devenu multimodal : vous pouvez charger des images et des PDF directement dans le chat IA pour les traiter.

Édition collaborative et versions de brouillon

L'édition collaborative a été intégrée en v11.15 avec des indicateurs de présence en direct (vous pouvez voir qui d'autre est en train de modifier le même élément) et un verrouillage au niveau champ pour éviter les conflits. La même version a ajouté un module de déploiement Vercel avec des permissions de déploiement basées sur les rôles.

La v11.16 a poussé la gestion du contenu plus loin avec des versions de brouillon globales. Chaque élément versionné obtient automatiquement une copie en brouillon. Les éditeurs peuvent prévisualiser les changements par rapport à la version en ligne et promouvoir les brouillons quand ils sont prêts. Les permissions de déploiement basées sur les rôles permettent à votre équipe éditoriale de préparer des changements sans les publier accidentellement en production.

Démarrer avec Directus (configuration Docker)

Vous pouvez lancer Directus localement avec Docker en moins de 2 minutes. Créez un fichier docker-compose.yml avec l'image directus/directus, définissez vos variables d'environnement pour la connexion à la base de données et les identifiants administrateur, puis lancez docker compose up. Directus démarre sur localhost:8055.

La configuration Docker nous a pris moins de 2 minutes depuis zéro. Voici un docker-compose.yml complet avec PostgreSQL inclus — pas juste le conteneur Directus, mais toute la stack :

# docker-compose.yml
version: "3"
services:
  database:
    image: postgis/postgis:16-3.4-alpine
    environment:
      POSTGRES_USER: directus
      POSTGRES_PASSWORD: directus
      POSTGRES_DB: directus
    volumes:
      - directus_data:/var/lib/postgresql/data

  directus:
    image: directus/directus:11.16
    ports:
      - "8055:8055"
    depends_on:
      - database
    environment:
      KEY: "your-random-key-here"
      SECRET: "your-random-secret-here"
      ADMIN_EMAIL: "[email protected]"
      ADMIN_PASSWORD: "change-me-please"
      DB_CLIENT: "pg"
      DB_HOST: "database"
      DB_PORT: "5432"
      DB_DATABASE: "directus"
      DB_USER: "directus"
      DB_PASSWORD: "directus"
    volumes:
      - directus_uploads:/directus/uploads

volumes:
  directus_data:
  directus_uploads:

Lancez-le :

docker compose up -d

Ouvrez http://localhost:8055, connectez-vous avec les identifiants administrateur que vous avez définis, et vous voilà dans le Data Studio. À partir de là, vous pouvez créer des collections (tables), définir des champs (colonnes) et commencer à gérer du contenu immédiatement. Les variables d'environnement KEY et SECRET sont utilisées pour la génération de tokens JWT — utilisez des chaînes aléatoires en production, pas les exemples ci-dessus.

Requêter les données avec le SDK Directus

Le SDK JavaScript de Directus fournit un accès typé à vos données via REST et GraphQL. Installez @directus/sdk, créez un client avec createDirectus(), et utilisez readItems() pour récupérer des collections avec filtrage, tri et sélection de champs intégrés.

Le pattern composable du SDK s'est révélé intuitif après avoir travaillé avec des bibliothèques comme le client Supabase. Vous commencez avec un client de base et ajoutez des capacités en composant des fonctions :

// lib/directus.ts
import { createDirectus, rest, readItems, createItem } from '@directus/sdk';

const client = createDirectus('http://localhost:8055').with(rest());

// Récupérer les articles publiés avec des champs spécifiques
const articles = await client.request(
  readItems('articles', {
    fields: ['id', 'title', 'slug', 'content', 'author.name'],
    filter: {
      status: { _eq: 'published' }
    },
    sort: ['-date_published'],
    limit: 10
  })
);

La création d'éléments suit le même pattern :

// Créer un nouvel article
const newArticle = await client.request(
  createItem('articles', {
    title: 'My New Post',
    slug: 'my-new-post',
    content: '<p>Hello from Directus.</p>',
    status: 'draft'
  })
);

Pour l'authentification, vous choisissez entre staticToken() (pour la communication serveur à serveur) et authentication() (pour les applications utilisateur avec flux de connexion) :

import { createDirectus, rest, staticToken } from '@directus/sdk';

// Côté serveur avec token statique
const client = createDirectus('http://localhost:8055')
  .with(staticToken('your-api-token'))
  .with(rest());

Exemples d'API REST

Chaque méthode du SDK a un endpoint REST équivalent. Si vous préférez travailler avec curl ou fetch directement :

# Récupérer les articles publiés
curl "http://localhost:8055/items/articles?filter[status][_eq]=published&sort=-date_published&limit=10&fields=id,title,slug"

# Créer un nouvel élément
curl -X POST "http://localhost:8055/items/articles" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Post", "status": "draft"}'

Requêtes GraphQL

Les mêmes données sont disponibles via GraphQL à /graphql :

query {
  articles(
    filter: { status: { _eq: "published" } }
    sort: ["-date_published"]
    limit: 10
  ) {
    id
    title
    slug
    content
    author {
      name
    }
  }
}

Vous n'avez pas besoin de configurer ou d'activer GraphQL séparément — il est toujours disponible en parallèle de REST.

Directus avec Next.js (intégration framework)

Connecter Directus à Next.js se fait en trois étapes : installez @directus/sdk, créez un client lib/directus.ts, et récupérez les données dans vos Server Components avec readItems(). Directus retourne du JSON brut, vous gardez donc un contrôle total sur le rendu sans composants spécifiques au fournisseur.

C'est la partie la plus propre du travail avec Directus. Pas d'adaptateur framework spécial, pas de composants React spécifiques à Directus, pas de plugin de build. C'est simplement de la récupération de données. Si vous avez déjà travaillé avec une API REST dans Next.js, vous savez déjà comment ça fonctionne. Pour le contexte sur les choix de framework, consultez notre comparatif Next.js vs Remix.

D'abord, créez le client partagé (c'est le même fichier que dans la section SDK, mais configuré pour votre instance déployée) :

// lib/directus.ts
import { createDirectus, rest, staticToken, readItems } from '@directus/sdk';

const directus = createDirectus(process.env.DIRECTUS_URL!)
  .with(staticToken(process.env.DIRECTUS_TOKEN!))
  .with(rest());

export default directus;
export { readItems };

Ensuite, utilisez-le dans un Server Component — pas de useEffect, pas d'états de chargement, juste async/await :

// app/blog/page.tsx
import directus, { readItems } from '@/lib/directus';

export default async function BlogPage() {
  const posts = await directus.request(
    readItems('posts', {
      fields: ['id', 'title', 'slug', 'excerpt', 'date_published'],
      filter: { status: { _eq: 'published' } },
      sort: ['-date_published'],
    })
  );

  return (
    <main>
      <h1>Blog</h1>
      {posts.map((post) => (
        <article key={post.id}>
          <h2><a href={`/blog/${post.slug}`}>{post.title}</a></h2>
          <p>{post.excerpt}</p>
          <time>{post.date_published}</time>
        </article>
      ))}
    </main>
  );
}

C'est tout. Aucune dépendance au fournisseur. La même approche fonctionne avec Astro, Nuxt, SvelteKit ou n'importe quel framework capable de faire des requêtes HTTP. La documentation officielle de Directus inclut des guides spécifiques pour Astro et Nuxt si vous en avez besoin, mais le pattern est identique : créer le client, appeler readItems(), rendre.

Tarifs et licences Directus CMS (2026)

Directus est gratuit à auto-héberger sous licence MIT pour les organisations dont les revenus annuels ou les financements totaux sont inférieurs à 5 M$. Au-delà de 5 M$, une licence commerciale est requise pour une utilisation en production. Directus Cloud commence à 25 $/mois (Starter), avec des plans Professional entre 49 $ et 499 $/mois, selon leur page de tarifs.

Le seuil de 5 millions de dollars

C'est le fait commercial le plus important à retenir sur Directus, et la plupart des guides soit l'enterrent soit le passent complètement sous silence. Voici comment ça fonctionne :

• Moins de 5 M$ de revenus annuels ou de financement total : Gratuit pour toujours. Licence MIT. Auto-hébergement n'importe où. Aucune restriction de fonctionnalités.
• Plus de 5 M$ en production : Une licence commerciale est nécessaire. Contactez le service commercial de Directus pour connaître les tarifs.
• Développement et test : Toujours gratuit, quelle que soit la taille de l'entreprise. Le seuil ne s'applique qu'aux déploiements en production.

Les 5 M$ incluent le financement en capital-risque, pas seulement les revenus. Donc une startup en phase d'amorçage avec 6 M$ de financement tombe techniquement au-dessus du seuil. En pratique, Directus n'a pas été agressif dans l'application de cette règle pour les entreprises en phase précoce, mais vous devriez en tenir compte dans votre planification.

Plans Cloud

Si vous ne voulez pas gérer l'infrastructure, Directus Cloud s'occupe de l'hébergement, des sauvegardes et des mises à jour :

• Starter : 25 $/mois — adapté aux petits projets et sites personnels
• Professional : 49 $-499 $/mois — évolue avec le stockage, la bande passante et les transformations d'assets
• Enterprise : Tarification personnalisée — SLA, infrastructure dédiée, support prioritaire

Pas de licence par siège. Toute votre équipe utilise le même plan. Comparez ça à Contentful, qui facture par utilisateur (voir notre analyse détaillée de Contentful), ou à Sanity, qui facture selon l'usage de l'API et la bande passante des datasets.

Directus vs Strapi vs Payload : la comparaison

Directus enveloppe des bases existantes sans migration, Strapi génère son propre schéma à partir des types de contenu, et Payload s'intègre directement dans votre application Next.js. Directus supporte 7 bases de données, Strapi en supporte 2, et Payload en supporte 2. Les trois sont open source, mais leurs philosophies sont assez différentes.

Ayant construit des projets avec Strapi et Directus, la plus grande différence réside dans la façon dont ils appréhendent votre base de données. Avec Strapi, vous définissez les types de contenu dans l'interface d'administration ou en code, et Strapi crée et gère les tables de base de données pour vous. Avec Directus, la base de données est la source de vérité — Directus la lit et s'y adapte.

Quand choisir Directus : Vous avez une base de données existante, vous voulez REST+GraphQL en double nativement, ou vous devez supporter des bases moins courantes comme OracleDB ou CockroachDB.

Quand choisir Strapi : Vous voulez le plus grand écosystème et la plus grande communauté, vous préférez définir les types de contenu via une interface, ou vous partez de zéro sans base de données existante. Lisez notre guide complet Strapi pour tous les détails.

Quand choisir Payload : Vous voulez le CMS intégré directement dans votre application Next.js, vous préférez une configuration TypeScript-first, ou vous avez besoin d'une Local API qui évite complètement HTTP. Consultez notre analyse approfondie de Payload CMS pour la vue d'ensemble.

Quand NE PAS utiliser Directus

Directus n'est pas le bon choix si vous avez besoin d'un page builder visuel, d'un framework Next.js étroitement intégré, ou d'un backend NoSQL. Il ajoute également de la complexité pour les projets simples où un CMS à fichiers plats ou WordPress suffirait.

Nous avons vu des équipes choisir Directus alors qu'elles n'auraient pas dû, et le schéma est généralement l'un de ceux-ci :

• Vous avez besoin d'un page builder visuel. Le Data Studio de Directus est excellent pour la gestion de données structurées, mais ce n'est pas un constructeur de site en glisser-déposer. Si l'édition visuelle est votre priorité, regardez du côté de Storyblok — consultez notre guide Storyblok pour comparer.
• Vous êtes engagé avec NoSQL. Directus est SQL uniquement par conception. Si vos données vivent dans MongoDB, Payload CMS est la solution naturelle.
• Votre projet est un simple blog. Lancer Docker, PostgreSQL et Directus pour un blog personnel est vraiment excessif. WordPress, Astro avec des fichiers markdown, ou même Ghost vous permettront de publier en une fraction du temps.
• Vous voulez le CMS dans votre framework. Si vous voulez que votre CMS vive dans votre codebase Next.js en tant que citoyen de première classe, Payload le fait nativement. Directus est toujours un service séparé.
• Vous êtes une grande organisation. Si votre entreprise dépasse le seuil de 5 M$ de revenus, vous aurez besoin d'une licence commerciale pour la production. Mettez ce coût en balance avec des alternatives entièrement open source comme Strapi ou Payload, où l'auto-hébergement est gratuit quelle que soit la taille de l'entreprise.

Ce ne sont pas des défauts — ce sont des décisions de conception. Directus est une plateforme de données, pas un constructeur de sites. Comprendre la différence vous évite des mois de frustration.

FAQ

Qu'est-ce que Directus CMS ?

Directus est un CMS headless open source qui enveloppe n'importe quelle base de données SQL existante avec des API REST et GraphQL instantanées. Il supporte PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB et MS-SQL. Contrairement aux CMS traditionnels, Directus ne crée pas son propre schéma — il lit et reflète automatiquement la structure de votre base de données existante.

Directus est-il vraiment gratuit ?

Directus est gratuit à auto-héberger sous licence MIT pour les organisations dont les revenus annuels ou le financement total sont inférieurs à 5 M$. Au-delà de ce seuil, une licence commerciale est requise pour la production. Les environnements de développement et de test sont toujours gratuits. Directus Cloud, leur hébergement managé, commence à 25 $ par mois.

En quoi Directus est-il différent de Strapi ?

Directus est database-first — il enveloppe votre base SQL existante sans modifier le schéma. Strapi est code-first — vous définissez des types de contenu et Strapi génère des tables de base de données. Directus supporte 7 bases de données tandis que Strapi en supporte 2. Les deux proposent des API REST, mais Directus inclut GraphQL nativement alors que Strapi nécessite un plugin.

Quelles bases de données Directus supporte-t-il ?

Directus supporte sept bases de données SQL : PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB et MS-SQL. Il se connecte à votre base existante et inspecte automatiquement le schéma. Ce support multi-bases est unique parmi les CMS headless — la plupart des concurrents ne supportent qu'un ou deux moteurs de base de données.

Directus peut-il remplacer WordPress ?

Directus peut remplacer WordPress pour la gestion de contenu, particulièrement pour les projets headless ou orientés API. Cependant, Directus n'a pas de frontend intégré, pas de thèmes, pas de page builder. Vous devrez construire votre propre frontend avec un framework comme Next.js ou Astro. Pour les blogs simples ou les sites nécessitant de l'édition visuelle, WordPress reste plus pratique.

Directus dispose-t-il d'un éditeur visuel ?

Directus inclut un Data Studio — une puissante interface d'administration pour gérer des données structurées, créer des tableaux de bord et configurer des permissions. Cependant, il ne propose pas de page builder visuel ni d'éditeur de site WYSIWYG comme Storyblok ou WordPress. Directus est conçu pour la gestion de données, pas la composition de pages en glisser-déposer.

Directus convient-il au e-commerce ?

Directus fonctionne bien comme système de gestion d'informations produits — vous pouvez modéliser des catalogues produits, gérer des attributs et servir des données via des API. Cependant, ce n'est pas une plateforme e-commerce. Vous n'aurez pas de panier d'achat, de flux de commande ni de traitement des paiements. Associez-le à Shopify, Saleor ou Medusa pour la couche transactionnelle.

Peut-on utiliser Directus avec Next.js ?

Oui. Installez le package @directus/sdk, créez un client pointant vers votre instance Directus, et récupérez les données dans des Server Components avec readItems(). Directus retourne du JSON brut, donc aucun composant React spécifique au fournisseur n'est requis. La même approche fonctionne avec n'importe quel framework JavaScript, notamment Astro, Nuxt et SvelteKit.

Directus supporte-t-il l'édition collaborative ?

Oui, depuis la version 11.15 (février 2026). Directus dispose d'une édition collaborative native avec des indicateurs de présence en direct montrant qui modifie quoi, et un verrouillage au niveau champ pour prévenir les conflits. C'est une fonctionnalité intégrée, pas un plugin. Combiné aux versions de brouillon globales de la v11.16, les équipes peuvent préparer et prévisualiser les changements avant de publier.

Qu'est-ce que le serveur MCP Directus ?

Directus a introduit un serveur Model Context Protocol natif en v11.13 (novembre 2025). Le MCP permet aux outils IA comme Claude et ChatGPT d'interagir directement avec votre contenu Directus — lire, créer et mettre à jour des éléments en langage naturel. Le serveur MCP respecte vos permissions RBAC existantes, donc l'accès IA suit les mêmes règles que les utilisateurs humains.