Directus CMS-guide: Database-først headless CMS til udviklere

Directus CMS-guide: Database-first headless CMS til udviklere

De fleste headless CMS'er vil have dig til at bygge din datamodel inde i deres system. Directus vender det på hovedet ved at lægge sig uden på din eksisterende SQL-database og give dig øjeblikkelige REST- og GraphQL-API'er uden at røre dit skema. Med ~34,5k GitHub-stjerner og brug hos virksomheder som Tripadvisor, Adobe og Mercedes-Benz er det en af de mest kompetente open source-løsninger blandt de bedste headless CMS-muligheder i 2026.

Hvad er Directus CMS?

Directus er et open source headless CMS, der lægger sig uden om enhver eksisterende SQL-database og giver øjeblikkelige REST- og GraphQL-API'er. I modsætning til Strapi eller Payload opretter Directus ikke sit eget databaseskema – det spejler dit. Det understøtter 7 databaser, herunder PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB og MS-SQL, og er gratis for organisationer med en omsætning under 5 mio. USD ifølge Directus' officielle dokumentation.

Tænk på det som et intelligent lag, der ligger oven på din database. Du har en eksisterende PostgreSQL-database med 50 tabeller, peger Directus på den, og i løbet af få minutter har du en komplet admin-grænseflade, rollebaseret adgangskontrol samt både REST- og GraphQL-endepunkter. Ingen migreringsscripts. Ingen dataomstrukturering.

Det er dét, "database-first" i virkeligheden betyder i praksis, og det er grundlæggende anderledes end code-first-tilgangen, som Strapi bruger (hvor du definerer indholdstyper, der genererer databasetabeller), eller den framework-integrerede tilgang i Payload CMS (hvor CMS'et bor inde i din Next.js-app).

Database-First-arkitektur forklaret

Da vi første gang forbandt Directus til en eksisterende PostgreSQL-database for et kundeprojekt, var det, der overraskede os, hvor lidt opsætning der var involveret. Directus introspecter dit databaseskema, tabeller bliver til "collections", kolonner bliver til "fields", og bygger sin admin-grænseflade ud fra det, der allerede eksisterer.

Det betyder, at dine data aldrig er låst fast i et proprietært format. Hvis du beslutter dig for at stoppe med at bruge Directus i morgen, er din database stadig en standard SQL-database. Prøv at gøre det med Contentful eller Sanity, hvor dit indhold ligger på deres servere i deres format.

Directus er heller ikke kun et CMS. Teamet positionerer det som en komponerbar dataplatform, folk bruger det til BaaS (Backend as a Service), interne admin-paneler og brugerdefinerede dashboards. CMS-use casen er den mest populære, men arkitekturen understøtter meget mere.

Nøglefunktioner i Directus

Directus tilbyder dobbelte REST- og GraphQL-API'er, detaljerede rollebaserede tilladelser, indbygget Flows-automatisering, et Data Studio med træk-og-slip, digital asset management og indbygget i18n-understøttelse af mere end 50 sprog. Siden v11.15 inkluderer det samarbejdsredigering og en AI Assistant som indbyggede funktioner, ikke tredjeparts-plugins.

Her er det, der betyder mest, hvis du overvejer Directus til et projekt:

Dobbelt REST- og GraphQL-API

Begge API'er er tilgængelige samtidigt fra de samme data, helt uden konfiguration. Du vælger ikke det ene frem for det andet — du får begge. Dit mobilteam kan bruge REST, mens din webfrontend bruger GraphQL. REST-API'et følger et forudsigeligt mønster (/items/{collection}), og GraphQL-endepunktet findes på /graphql.

Flows og automatisering

Flows er Directus' hændelsesdrevne automatiseringssystem, der er indbygget direkte i Data Studio-brugerfladen. Du kan udløse workflows ved CRUD-hændelser (element oprettet, opdateret, slettet), tidsplaner (cron-stil) eller webhooks. Operationerne omfatter afsendelse af e-mails, udførelse af HTTP-forespørgsler, kørsel af brugerdefineret JavaScript og transformation af data.

For teams, der bygger med AI, har Directus endda en indbygget Model Context Protocol (MCP)-guide-server, men mere om det i v11-afsnittet.

Udvidelser og tilpasning

Udvidelsessystemet understøtter hooks (server-side event handlers), brugerdefinerede endpoints, UI-paneler, fulde moduler og operation-nodes til Flows. Udvidelser bygges med Vue.js til frontend og almindelig Node.js til backend. I v11.0-udgivelsen blev udvidelser omstruktureret fra typebaserede mapper til et renere samlet format.

Sådan klarer Directus sig i forhold til konkurrenterne på funktioner:

Hvad er nyt i Directus v11 (2025-2026)

Directus v11 introducerede indbygget understøttelse af MCP-servere (v11.13), en AI-assistent der understøtter OpenAI, Anthropic og Gemini (v11.14), samarbejdsredigering med live tilstedeværelsesindikatorer (v11.15) samt globale kladdeversioner med rollebaserede distributionsrettigheder (v11.16). Disse er alle indbyggede funktioner, ikke community-udvidelser.

Det er her, Directus har udviklet sig hurtigst, og det er den sektion, de fleste konkurrenter overser fuldstændigt. Kun én af de seks højest rangerede guides dækker noget af dette.

MCP-server og AI-assistent

Med v11.13-udgivelsen blev Directus et af de første CMS'er med en indbygget MCP-server. Hvis du bruger Claude, ChatGPT eller et hvilket som helst MCP-kompatibelt AI-værktøj, kan det administrere dit Directus-indhold direkte – læse samlinger, oprette elementer og opdatere felter, alt sammen mens dine RBAC-rettigheder overholdes. Hvis MCP er nyt for dig, forklarer vores Model Context Protocol (MCP)-guide protokollen i detaljer.

AI-assistenten (v11.14) er adskilt fra MCP – det er en indbygget chatgrænseflade i Data Studio, der understøtter OpenAI, Anthropic, Gemini og endda lokale modeller via Ollama. Med v11.16 blev den multimodal: Du kan uploade billeder og PDF'er direkte i AI-chatten til behandling.

Samarbejdsredigering og kladdeversioner

Samarbejdsredigering blev udgivet i v11.15 med live tilstedeværelsesindikatorer (du kan se, hvem der ellers redigerer det samme element) og feltlåse på feltniveau for at forhindre konflikter. Samme udgivelse tilføjede et Vercel-deployeringsmodul med rollebaserede deployeringstilladelser.

v11.16 bragte content staging videre med globale kladdeversioner. Alle versionerede elementer får automatisk en kladdekopi. Redaktører kan forhåndsvise ændringer i forhold til den live version og fremme kladder, når de er klar. Rollebaserede deployeringstilladelser betyder, at dit indholdsteam kan scene ændringer uden utilsigtet at skubbe til produktion.

Kom i gang med Directus (Docker-opsætning)

Du kan køre Directus lokalt med Docker på under 2 minutter. Opret en docker-compose.yml-fil med directus/directus-imaget, angiv din databaseforbindelse og admin-legitimationsoplysninger som miljøvariabler, og kør derefter docker compose up. Directus starter på localhost:8055.

Docker-opsætningen tog os under 2 minutter fra en kold start. Her er en komplet docker-compose.yml med PostgreSQL inkluderet, ikke kun Directus-containeren, men hele stacken:

# 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:

Run it:

docker compose up -d

Åbn http://localhost:8055, log ind med de administratoroplysninger, du har angivet, og du er inde i Data Studio. Herfra kan du oprette collections (tabeller), definere felter (kolonner) og begynde at administrere indhold med det samme. Miljøvariablerne KEY og SECRET bruges til generering af JWT-tokens – brug tilfældige strenge i produktion, ikke pladsholderne ovenfor.

Forespørge data med Directus SDK

Directus JavaScript SDK giver typesikker adgang til dine data via både REST og GraphQL. Installer @directus/sdk, opret en klient med createDirectus(), og brug readItems() til at hente kollektioner med indbygget filtrering, sortering og feltvalg.

SDK'ens komposable mønster føltes intuitivt efter at have arbejdet med biblioteker som Supabases klient. Du starter med en basisklient og tilføjer funktioner ved at komponere funktioner:

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

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

// Fetch published articles with specific fields
const articles = await client.request(
  readItems('articles', {
    fields: ['id', 'title', 'slug', 'content', 'author.name'],
    filter: {
      status: { _eq: 'published' }
    },
    sort: ['-date_published'],
    limit: 10
  })
);

Oprettelse af elementer følger samme mønster:

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

Til autentificering vælger du mellem staticToken() (til server-til-server-kommunikation) og authentication() (til brugervendte apps med login-flows):

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

// Server-side with static token
const client = createDirectus('http://localhost:8055')
  .with(staticToken('your-api-token'))
  .with(rest());

REST API-eksempler

Alle SDK-metoder har et tilsvarende REST-endepunkt. Hvis du foretrækker at arbejde direkte med curl eller fetch:

# Hent udgivne artikler
curl "http://localhost:8055/items/articles?filter[status][_eq]=published&sort=-date_published&limit=10&fields=id,title,slug"
# Opret et nyt element
curl -X POST \"http://localhost:8055/items/articles\" \
  -H \"Authorization: Bearer YOUR_TOKEN\" \
  -H \"Content-Type: application/json\" \
  -d '{\"title\": \"My Post\", \"status\": \"draft\"}'

GraphQL-forespørgsler

De samme data er tilgængelige via GraphQL på /graphql:

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

Du behøver ikke at konfigurere eller aktivere GraphQL separat – det er altid tilgængeligt sammen med REST.

Directus med Next.js (framework-integration)

Det kræver tre trin at forbinde Directus til Next.js: installér @directus/sdk, opret en lib/directus.ts-klient, og hent data i dine Server Components med readItems(). Directus returnerer rå JSON, så du har fuld kontrol over renderingen uden leverandørspecifikke komponenter.

Det er den reneste del af at arbejde med Directus. Der er ingen speciel framework-adapter, ingen Directus-specifikke React-komponenter, intet build-plugin. Det er bare datahentning. Hvis du har arbejdet med et REST API i Next.js, ved du allerede, hvordan det fungerer. For kontekst om framework-valg, se vores Next.js vs Remix-sammenligning.

Først opretter du den delte klient (det er den samme fil som i SDK-sektionen, men konfigureret til din deployede instans):

// 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 };

Brug den derefter i en Server Component — ingen useEffect, ingen loading-tilstande, bare 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>
  );
}

Det er det hele. Ingen vendor lock-in. Den samme tilgang fungerer med Astro, Nuxt, SvelteKit eller ethvert framework, der kan foretage HTTP-forespørgsler. Directus' officielle dokumentation indeholder frameworkspecifikke guides til Astro og Nuxt, hvis du ønsker dem, men mønsteret er identisk: opret klient, kald readItems(), render.

Directus CMS-priser og licensering (2026)

Directus er gratis at selvhoste under MIT-licensen for organisationer med en årlig omsætning eller finansiering på under 5 mio. USD. Over 5 mio. USD kræves en kommerciel licens til produktionsbrug. Directus Cloud starter ved $25/md. (Starter) med Professional-planer fra $49–$499/md. ifølge deres prisoversigt.

5 mio. $-omsætningsgrænsen

Dette er den vigtigste forretningsmæssige kendsgerning om Directus, og de fleste guides begraver den eller springer den helt over. Sådan fungerer det:

• Under 5 mio. $ i årlig omsætning eller samlet finansiering: Gratis for altid. MIT-licens. Self-host hvor som helst. Ingen funktionsbegrænsninger.
• Over 5 mio. $ i produktion: Du har brug for en kommerciel licens. Kontakt Directus' salgsafdeling for priser.
• Udvikling og test: Altid gratis, uanset virksomhedens størrelse. Grænsen gælder kun for produktion-installationer.

De 5 mio. $ inkluderer venture-finansiering, ikke kun omsætning. Så en seed-fase startup med 6 mio. $ i finansiering ligger teknisk set over grænsen. I praksis har Directus ikke været aggressive med håndhævelse over for tidlige virksomheder, men du bør tage højde for dette i din planlægning.

Cloud-planer

Hvis du ikke selv vil administrere infrastruktur, klarer Directus Cloud hosting, backups og opdateringer:

• Starter: $25/md., velegnet til små projekter og personlige sites
• Professional: $49-$499/md., skalerer med lagerplads, båndbredde og asset-transformationer
• Enterprise: Tilpasset pris, SLA, dedikeret infrastruktur, prioriteret support

Ingen licens pr. bruger. Hele dit team bruger samme plan. Sammenlign det med Contentful, som opkræver pr. bruger (se vores gennemgang af Contentful-priser), eller Sanity, som opkræver baseret på API-brug og datasætbåndbredde.

Directus vs Strapi vs Payload: Sådan sammenlignes de

Directus omslutter eksisterende databaser uden migrering, Strapi genererer sit eget skema ud fra indholdstyper, og Payload indlejres direkte i din Next.js-app. Directus understøtter 7 databaser, Strapi understøtter 2, og Payload understøtter 2. Alle tre er open source, men deres filosofier er ret forskellige.

Efter at have bygget projekter med både Strapi og Directus er den største forskel, hvordan de tænker på din database. Med Strapi definerer du indholdstyper i admin-brugerfladen eller i kode, og Strapi opretter og administrerer databasetabellerne for dig. Med Directus er databasen den eneste sande kilde – Directus læser den og tilpasser sig.

Hvornår du skal vælge Directus: Du har en eksisterende database, du vil have både REST og GraphQL direkte fra starten, eller du har brug for at understøtte mindre udbredte databaser som OracleDB eller CockroachDB.

Hvornår du skal vælge Strapi: Du vil have det største økosystem og fællesskab, du foretrækker at definere indholdstyper via en brugerflade, eller du starter fra bunden uden en eksisterende database. Læs vores komplette Strapi-guide for flere detaljer.

Hvornår du skal vælge Payload: Du vil have CMS'et indlejret direkte i din Next.js-applikation, du foretrækker TypeScript-først konfiguration, eller du har brug for et lokalt API, der helt springer HTTP over. Se vores dybdegående Payload CMS-gennemgang for det fulde billede.

Hvornår du IKKE skal bruge Directus

Directus er ikke det rigtige valg, hvis du har brug for en visuel page builder, et tæt integreret Next.js-framework eller en NoSQL-backend. Det tilføjer også overhead til simple projekter, hvor et flat-file CMS eller WordPress ville være tilstrækkeligt.

Vi har set teams vælge Directus, når de ikke burde have gjort det, og mønsteret er som regel et af følgende:

• Du har brug for en visuel page builder. Directus' Data Studio er fremragende til struktureret datahåndtering, men det er ikke en drag-and-drop site builder. Hvis visuel redigering er din prioritet, så kig på Storyblok, se vores Storyblok-guide for hvordan den sammenlignes.
• Du er dedikeret til NoSQL. Directus er SQL-only af design. Hvis dine data ligger i MongoDB, er Payload CMS det naturlige valg.
• Dit projekt er en simpel blog. At starte Docker, PostgreSQL og Directus op til en personlig blog er seriøst overkill. WordPress, Astro med markdown-filer eller endda Ghost får dig til at udgive på en brøkdel af tiden.
• Du vil have CMS i frameworket. Hvis du vil have dit CMS til at leve inde i din Next.js-codebase som en first-class citizen, gør Payload dette nativt. Directus er altid en separat service.
• Du er en stor organisation. Hvis din virksomhed overstiger $5M-omsætningsgrænsen, skal du bruge en kommerciel licens til produktion. Modregn den omkostning mod fuldt open source-alternativer som Strapi eller Payload, hvor self-hosting er gratis uanset omsætning.

Ingen af disse er fejl, de er designbeslutninger. Directus er en dataplatform, ikke en website builder. At kende forskellen sparer dig for måneders frustration.

Ofte stillede spørgsmål

Hvad er Directus CMS?

Directus er et open source headless CMS, der omgiver enhver eksisterende SQL-database med øjeblikkelige REST- og GraphQL-API'er. Det understøtter PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB og MS-SQL. I modsætning til traditionelle CMS'er opretter Directus ikke sit eget skema – det læser og spejler automatisk din eksisterende databasestruktur.

Er Directus virkelig gratis?

Directus er gratis at selv-hoste under en MIT-licens for organisationer med en årlig omsætning eller samlet finansiering på under $5M. Over denne grænse kræves en kommerciel licens til produktionsbrug. Udviklings- og testmiljøer er altid gratis. Directus Cloud, deres administrerede hosting, starter ved $25 om måneden.

Hvordan adskiller Directus sig fra Strapi?

Directus er database-først og udenpå din eksisterende SQL-database uden at ændre skemaet. Strapi er kode-først, hvor du definerer indholdstyper, og Strapi genererer databasetabeller. Directus understøtter 7 databaser, mens Strapi understøtter 2. Begge tilbyder REST API'er, men Directus har indbygget GraphQL, mens Strapi kræver et plugin.

Hvilke databaser understøtter Directus?

Directus understøtter syv SQL-databaser: PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB og MS-SQL. Den opretter forbindelse til din eksisterende database og introspekterer skemaet automatisk. Denne understøttelse af flere databaser er unik blandt headless CMS-systemer, da de fleste konkurrenter kun understøtter én eller to databasemotorer.

Kan Directus erstatte WordPress?

Directus kan erstatte WordPress til indholdsstyring, især til headless- eller API-drevne projekter. Directus har dog ingen indbygget frontend, temaer eller page builder. Du skal bygge din egen frontend med et framework som Next.js eller Astro. Til simple blogs eller sites, der kræver visuel redigering, er WordPress stadig mere praktisk.

Har Directus en visuel editor?

Directus inkluderer en Data Studio, en kraftfuld admin-grænseflade til at administrere strukturerede data, bygge dashboards og konfigurere rettigheder. Den har dog ikke en visuel sidebygger eller en WYSIWYG-webstedseditor som Storyblok eller WordPress. Directus er designet til datastyring, ikke til sideopbygning med træk og slip.

Er Directus velegnet til e-handel?

Directus fungerer godt som et Product Information Management-system – du kan modellere produktkataloger, administrere attributter og levere data via API'er. Det er dog ikke en e-handelsplatform. Du får ikke en indkøbskurv, en checkout-proces eller betalingshåndtering. Kombinér det med Shopify, Saleor eller Medusa til det transaktionelle lag.

Kan jeg bruge Directus med Next.js?

Ja. Installer @directus/sdk-pakken, opret en klient, der peger på din Directus-instans, og hent data i Server Components ved hjælp af readItems(). Directus returnerer almindelig JSON, så der kræves ingen leverandørspecifikke React-komponenter. Den samme fremgangsmåde fungerer med alle JavaScript-frameworks, herunder Astro, Nuxt og SvelteKit.

Understøtter Directus samarbejdsredigering?

Ja, siden version 11.15 (februar 2026). Directus har indbygget samarbejdsredigering med tilstedeværelsesindikatorer i realtid, der viser, hvem der redigerer hvad, samt låsning på feltniveau for at forhindre konflikter. Dette er en indbygget funktion, ikke et plugin. Kombineret med globale kladderversioner i v11.16 kan teams klargøre og forhåndsvise ændringer før publicering.

Hvad er Directus MCP-serveren?

Directus introducerede en indbygget Model Context Protocol-server i v11.13 (november 2025). MCP gør det muligt for AI-værktøjer som Claude og ChatGPT at interagere direkte med dit Directus-indhold ved at læse, oprette og opdatere elementer via naturligt sprog. MCP-serveren respekterer dine eksisterende RBAC-tilladelser, så AI-adgang følger de samme regler som for menneskelige brugere.