Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Directus
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Directus ist ein Headless-CMS: Es legt eine Verwaltungsoberfläche und eine REST- und GraphQL-Schnittstelle über eine SQL-Datenbank. Tabellen und Felder richtet man im Browser ein, die Inhalte holen sich Websites, Apps oder Skripte über die Schnittstelle. Anders als bei Strapi entstehen dabei keine Code-Dateien, alles steht in der Datenbank.
Vorbemerkungen
- Kein apt-Paket: Directus ist nicht in den Ubuntu-Paketquellen enthalten. Es wird pro Projekt über
npminstalliert. Node.js und npm kommen aus den Ubuntu-Paketquellen. - Voraussetzung: PostgreSQL ist installiert und läuft. Directus kann auch MySQL, MariaDB und SQLite verwenden.
- Lizenz: Directus ist quelloffen, aber keine Open-Source-Software. Es steht unter der „Monospace Sustainable Core License“ (MSCL). Kostenlos erlaubt sind unter anderem die eigene interne Nutzung, nicht kommerzielle Lehre und Forschung sowie das Einrichten für Kunden. Nicht erlaubt ist, Directus als Konkurrenzangebot zum kostenpflichtigen Angebot des Herstellers bereitzustellen. Jede Version wird vier Jahre nach ihrem Erscheinen zusätzlich unter der GPL-3.0 freigegeben. Den vollständigen Text findest du nach der Installation in
~/meindirectus/node_modules/directus/license. - Adresse: Directus läuft hier unter http://localhost:8055, nur vom eigenen Rechner aus erreichbar.
- Version: Getestet mit Directus 12.4.1 unter Node.js 22 und npm 9 aus Ubuntu 26.04 und PostgreSQL 18. Directus 12 braucht Node.js 22 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js und npm installieren
Node.js führt Directus aus, npm lädt es herunter. Sind beide schon vorhanden, meldet apt das nur.
sudo apt install nodejs npm
Prüfen: Die Ausgabe ist eine Versionsnummer ab v22, z. B. v22.22.1.
node --version
Hast du Node.js zusätzlich über den Versionsmanager nvm installiert, wird dessen Version angezeigt. Das ist in Ordnung, solange sie mindestens v22 ist.
Datenbank in PostgreSQL einrichten
3. Datenbankbenutzer anlegen
Directus meldet sich mit diesem Benutzer bei PostgreSQL an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 10.
sudo -u postgres psql -c "CREATE USER directus WITH PASSWORD 'geheimes_passwort';"
Prüfen: Die Ausgabe lautet CREATE ROLE.
4. Datenbank anlegen
sudo -u postgres psql -c "CREATE DATABASE directus OWNER directus ENCODING 'UTF8';"
Prüfen: Die Ausgabe lautet CREATE DATABASE.
Projekt anlegen
5. Projektordner anlegen
In diesem Ordner liegen Directus, seine Einstellungen und die hochgeladenen Dateien.
mkdir ~/meindirectus
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meindirectus
7. Directus herunterladen
Lädt Directus mit allen Bibliotheken in den Unterordner node_modules und legt die Datei package.json an. Das dauert etwa eine Minute.
npm install directus
Prüfen: Die Ausgabe lautet 12.4.1 oder eine neuere Versionsnummer.
npx directus --version
8. Ordner für Uploads und Erweiterungen anlegen
Directus legt hochgeladene Dateien in uploads ab und lädt Erweiterungen aus extensions. Fehlen die Ordner, meldet Directus beim Start is not read/writeable bzw. is not readable.
mkdir uploads extensions
9. Geheimen Schlüssel erzeugen
Directus unterschreibt damit die Anmeldungen. Der Befehl gibt eine zufällige Zeichenkette aus 64 Zeichen aus. Markiere sie und kopiere sie mit Strg+Umschalt+C. Du brauchst sie im nächsten Schritt.
openssl rand -hex 32
10. Einstellungsdatei anlegen
Directus liest seine Einstellungen aus der Datei .env im Projektordner.
nano .env
Füge diesen Inhalt ein (Strg+Umschalt+V):
HOST=127.0.0.1
PORT=8055
PUBLIC_URL=http://localhost:8055
SECRET=HIER_DEN_SCHLUESSEL_EINSETZEN
DB_CLIENT=pg
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=directus
DB_USER=directus
DB_PASSWORD=geheimes_passwort
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=Ein-langes-Passwort-2026
TELEMETRY=false
PROJECT_OWNER_ENABLED=false
Passe dann diese Werte an:
SECRET– ersetzeHIER_DEN_SCHLUESSEL_EINSETZENdurch den Schlüssel aus Schritt 9.DB_PASSWORD– das Datenbankpasswort aus Schritt 3.ADMIN_EMAILundADMIN_PASSWORD– deine Anmeldedaten für die Verwaltung. Sie werden nur in Schritt 11 gebraucht.
Die übrigen Zeilen bedeuten:
HOST=127.0.0.1undPORT=8055– Directus ist nur vom eigenen Rechner aus erreichbar.DB_…– die Verbindung zur Datenbank aus Schritt 3 und 4.pgsteht für PostgreSQL.TELEMETRY=false– Directus schickt keine Nutzungsdaten an den Hersteller.PROJECT_OWNER_ENABLED=false– Directus fragt nicht nach einem „Projektinhaber“. Ohne diese Zeile erscheint nach der Anmeldung ein Dialog, der E-Mail-Adresse und Verwendungszweck an den Hersteller schickt.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Die Datei .env enthält Passwörter und den geheimen Schlüssel. Gib sie nicht weiter und lade sie nicht in ein öffentliches Git-Repository hoch.
11. Datenbank einrichten
bootstrap legt die Tabellen von Directus in der Datenbank an und erzeugt das Administratorkonto mit den Daten aus ADMIN_EMAIL und ADMIN_PASSWORD.
npx directus bootstrap
Prüfen: Die letzten Zeilen lauten Adding first admin user... und Done.
12. Administratorpasswort aus der Einstellungsdatei entfernen
Das Konto ist jetzt angelegt. Die beiden Zeilen werden nicht mehr gebraucht, und das Passwort soll nicht dauerhaft im Klartext in der Datei stehen.
nano .env
Drücke Strg+W, gib ADMIN_EMAIL ein und drücke Enter. Drücke dann zweimal Strg+K. Das löscht die Zeilen ADMIN_EMAIL=… und ADMIN_PASSWORD=…. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: Der Befehl gibt nichts aus.
grep ADMIN_ .env
Directus verwenden
13. Directus starten
Startet den Server im Terminal. Er läuft so lange, bis du ihn mit Strg+C beendest.
npx directus start
Prüfen: Nach wenigen Sekunden erscheint Server started at http://127.0.0.1:8055. Die Warnung PostGIS isn't installed kannst du ignorieren. PostGIS braucht man nur für Geodaten.
14. An der Verwaltung anmelden
Öffne http://localhost:8055 im Browser. Directus leitet auf die Anmeldeseite unter /admin weiter. Melde dich mit E-Mail-Adresse und Passwort aus Schritt 10 an.
15. Lizenzfrage beantworten
Nach der ersten Anmeldung fragt Directus „Have a license key?“. Für die kostenlose Nutzung:
- Klicke auf I'm using Core plan.
- Wähle unter „What are you using Directus for?“ den passenden Zweck, z. B. Personal / Side project.
- Klicke auf Save.
Die Antwort wird nur in deiner eigenen Datenbank gespeichert. Klickst du stattdessen auf Skip, erscheint die Frage bei jeder Anmeldung wieder.
Prüfen: Links steht „Content“ mit dem Hinweis „No Collections“.
16. Oberfläche auf Deutsch umstellen
- Klicke in der linken Leiste auf das Zahnrad (Settings) und dann auf Settings.
- Wähle im Feld Default Language den Eintrag German (Germany).
- Klicke oben rechts auf Save (Häkchen).
- Lade die Seite mit F5 neu.
Prüfen: Die Menüs heißen jetzt „Datenmodell“, „Benutzerrollen“, „Einstellungen“ usw. Die Einstellung gilt für alle Benutzer, die keine eigene Sprache gewählt haben.
17. Eine Sammlung anlegen
Eine Sammlung ist eine Tabelle in der Datenbank, z. B. für Artikel. Ein Beispiel:
- Klicke in der linken Leiste auf das Zahnrad, dann auf Datenmodell und oben rechts auf Erstellen.
- Gib als Name
artikelein. Klicke oben rechts auf Weiter und danach auf Einrichtung abschließen. Das Primärschlüsselfeldidlegt Directus selbst an. - Klicke in der neuen Sammlung auf Feld erstellen und wähle Eingabe. Gib als Schlüssel
titelein und klicke auf Speichern. - Klicke in der linken Leiste ganz oben auf den Würfel (Inhalt), dann auf Artikel und oben rechts auf Erstellen. Gib einen Titel ein und klicke auf Speichern.
18. Artikel öffentlich lesbar machen
Ohne Anmeldung liefert die Schnittstelle zunächst nichts aus.
- Klicke in der linken Leiste auf das Zahnrad, dann auf Zugangsrichtlinien und in der Liste auf Öffentlich.
- Klicke unter „Permissions“ auf Sammlung hinzufügen und wähle
artikel. - In der neuen Zeile
artikelstehen die Aktionen „Erstellen“, „Lesen“, „Aktualisieren“, „Löschen“ und „Teilen“. Klicke auf Lesen und wähle Kompletter Zugriff. „Lesen“ wird daraufhin farbig hervorgehoben. - Klicke oben rechts auf Speichern.
Prüfen: Öffne ein zweites Terminal. Die Ausgabe enthält deinen Artikel, z. B. {"data":[{"id":1,"titel":"Hallo Directus"}]}. Vor der Freigabe steht dort You don't have permission to access collection "artikel".
curl http://localhost:8055/items/artikel
Beende Directus im ersten Terminal mit Strg+C.
Aktualisieren
Lege vorher eine Sicherung des Projektordners und der Datenbank an.
1. In den Projektordner wechseln
cd ~/meindirectus
2. Nach neuen Versionen sehen
Zeigt eine Tabelle mit der installierten (Current) und der neuesten Version (Latest). Gibt der Befehl nichts aus, ist Directus aktuell.
npm outdated directus
3. Directus aktualisieren
Installiert die neueste Version. Beim Sprung auf eine neue Hauptversion (z. B. von 12 auf 13) liest man vorher die Hinweise unter https://directus.com/docs.
npm install directus@latest
4. Datenbank anpassen
Neue Versionen bringen oft geänderte Tabellen mit. Directus muss dafür beendet sein.
npx directus database migrate:latest
Prüfen: Die Ausgabe endet mit Database up to date.
Deinstallieren
1. Directus beenden
Läuft Directus noch in einem Terminal, beende es dort mit Strg+C.
2. Projektordner löschen
Achtung: Damit sind auch hochgeladene Bilder und Dateien gelöscht. Sie liegen in ~/meindirectus/uploads.
rm -r ~/meindirectus
3. Datenbank löschen
Achtung: Damit sind alle Sammlungen, Inhalte und Konten gelöscht.
sudo -u postgres psql -c "DROP DATABASE IF EXISTS directus;"
4. Datenbankbenutzer löschen
sudo -u postgres psql -c "DROP USER IF EXISTS directus;"
Prüfen: Directus ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8055
5. npm-Zwischenspeicher leeren (optional)
npm bewahrt heruntergeladene Pakete in ~/.npm auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle Node.js-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
npm cache clean --force
Node.js, npm und PostgreSQL bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.directus.io/
- Lizenz: Directus steht unter der BSL-1.1 / Apache-2.0.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.