Directus

Directus est un CMS headless et une plateforme de données open source qui enveloppe toute base de données SQL d’une API REST et GraphQL ainsi que d’une application d’administration sans code. Vous le connectez à une base de données et obtenez immédiatement la gestion de contenu, le stockage de ressources et un contrôle d’accès granulaire. L’image Docker officielle constitue la méthode recommandée pour l’auto-hébergement.

Logiciels inclus

Composant	Version
Directus	12.1.1
PostgreSQL with PostGIS	16 / 3.5
Ubuntu	24.04 LTS

Variables d’environnement

Définissez-les facultativement lors du déploiement depuis la marketplace. Laissez un champ vide pour qu’une valeur sécurisée soit générée.

Variable	Description
`ADMIN_EMAIL`	Adresse courriel de l’administrateur Directus
`ADMIN_PASSWORD`	Mot de passe de l’administrateur Directus

Démarrage

1. Se connecter à votre VM

ssh ubuntu@<your-vm-ip>

2. Attendre la configuration du premier démarrage

Au premier démarrage, un script de configuration génère des secrets uniques pour l’application et la base de données, démarre PostgreSQL/PostGIS et Directus, puis crée le compte administrateur. Suivez la progression :

journalctl -u directus-first-boot.service -f

Le message de connexion (MOTD) confirme que Directus est prêt.

3. Vérifier que Directus fonctionne

cd /opt/directus
docker compose ps
curl -fsS http://127.0.0.1:8055/server/ping

4. Accéder à l’interface Directus

Ouvrez un navigateur et accédez à :

http://<your-vm-ip>:8055

Récupérez les identifiants de l’administrateur :

sudo cat /etc/directus/credentials.txt

Champ	Valeur
Adresse courriel	Dans `/etc/directus/credentials.txt`
Mot de passe	Dans `/etc/directus/credentials.txt`

Gérer Directus

# Check container status
cd /opt/directus && docker compose ps

# Restart
cd /opt/directus && docker compose restart

# View logs
cd /opt/directus && docker compose logs -f

Chemin	Fonction
`/opt/directus/docker-compose.yml`	Configuration Docker Compose
`/opt/directus/.env`	Paramètres de l’application et de la base
`/var/lib/directus/database/`	Données PostgreSQL/PostGIS
`/var/lib/directus/uploads/`	Fichiers téléversés
`/var/lib/directus/extensions/`	Extensions Directus

Sécurité

Le port 8055 est accessible sur l’interface réseau de la VM. UFW est activé et autorise par défaut SSH (port 22) et Directus (port 8055).

Pour limiter l’interface et l’API à une adresse IP précise :

sudo ufw delete allow 8055/tcp
sudo ufw allow from <trusted-ip> to any port 8055

Pour accéder à Directus sans exposer le port 8055, utilisez un tunnel SSH :

# Run this on your local machine
ssh -L 8055:localhost:8055 ubuntu@<your-vm-ip>

# Then open in your browser
http://localhost:8055

Pour une utilisation en production, placez Directus derrière un proxy inverse afin de le servir sur le port 443 avec un certificat TLS, puis remplacez l’URL publique de Directus par l’URL HTTPS.