🚀 Coolify + Astro + Strapi

1. Vue d’ensemble de la stack

Cette stack assemble quatre composants pour produire un site vitrine statique performant, gérable par un non-développeur via un éditeur de contenu moderne, et déployé automatiquement à chaque modification.

Cycle complet de mise à jour

1. Le gestionnaire de contenu crée ou modifie un item dans Strapi
2. Le webhook Strapi se déclenche sur l’événement (entry.update, entry.publish...)
3. Le webhook effectue un GET HTTP vers l’API Coolify avec l’UUID de l’application et &force=true
4. Coolify lance le build Docker du projet Astro
5. Astro fetch toutes les collections Strapi via l’API REST
6. Astro génère le dist/ statique avec les nouvelles données
7. nginx Alpine est construit avec le nouveau dist/
8. Coolify remplace l’ancien container
9. Le site est à jour

2. Comparatif Directus vs Strapi — Quand choisir l’un ou l’autre ?

Tableau comparatif détaillé

Règle de décision

3. Prérequis

• Coolify installé et opérationnel (voir guide Coolify + Astro + Directus)
• Accès SSH au VPS Coolify
• Repo GitHub du site Astro existant
• Entrée DNS locale pour strapi.monsite.local pointée sur l’IP du VPS (dans /etc/hosts du VPS et de la machine cliente)

4. Déploiement Strapi via Coolify

sudo bash -c 'echo "127.0.0.1 strapi.monsite.local" >> /etc/hosts'

echo [IP_VPS] strapi.monsite.local >> C:\Windows\System32\drivers\etc\hosts

5. Création des collections via l’API

Les collections peuvent être créées via l’API admin Strapi (token JWT) ou via l’interface Content-Type Builder. Voici la méthode API :

Authentification admin

curl -X POST http://strapi.monsite.local/admin/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"admin@example.com","password":"motdepasse"}'
# Récupérer le token dans data.token

Création d’une collection (exemple : Service)

curl -X POST http://strapi.monsite.local/content-type-builder/content-types \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer [TOKEN_ADMIN]' \
  -d '{
    "contentType": {
      "displayName": "Service",
      "singularName": "service",
      "pluralName": "services",
      "kind": "collectionType",
      "attributes": {
        "titre": {"type": "string", "required": true},
        "description": {"type": "text"},
        "ordre": {"type": "integer"}
      }
    }
  }'

Injection de données (avec API Token)

curl -X POST http://strapi.monsite.local/api/services \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer [API_TOKEN]' \
  -d '{"data": {"titre": "Infogérance IT", "description": "...", "ordre": 1}}'

6. Générer un API Token Strapi

7. Intégration Astro → Strapi

Récupérer l’IP interne de Strapi

sudo docker inspect [NOM_CONTAINER_STRAPI] | grep '"IPAddress"'
# Ex : [IP_INTERNE_STRAPI]

Code Astro — fetch depuis Strapi

---
const STRAPI = 'http://[IP_INTERNE_STRAPI]:1337';
const STRAPI_TOKEN = 'votre_api_token_ici';
const headers = { 'Authorization': `Bearer ${STRAPI_TOKEN}` };

const [servicesRes, tarifsRes] = await Promise.all([
  fetch(`${STRAPI}/api/services?sort=ordre&pagination[limit]=100`, { headers }),
  fetch(`${STRAPI}/api/tarifs?sort=ordre&pagination[limit]=100`, { headers }),
]);

const services = (await servicesRes.json()).data ?? [];
const tarifs = (await tarifsRes.json()).data ?? [];
---

8. Webhook Strapi → rebuild Coolify automatique

Configuration via l’API admin Strapi. Récupérer d’abord un token admin frais, puis :

curl -X POST http://strapi.monsite.local/admin/webhooks \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer [TOKEN_ADMIN]' \
  -d '{
    "name": "coolify-rebuild",
    "url": "http://[IP_VPS]:8001/api/v1/deploy?uuid=[UUID_APP]&force=true",
    "headers": {
      "Authorization": "Bearer [TOKEN_API_COOLIFY]"
    },
    "events": [
      "entry.create",
      "entry.update",
      "entry.delete",
      "entry.publish",
      "entry.unpublish"
    ]
  }'

9. Problèmes rencontrés et solutions

10. Résumé des commandes utiles

Vérifier l’IP interne du container Strapi

sudo docker inspect $(sudo docker ps | grep strapi | grep -v postgres | awk '{print $1}') \
  | python3 -c "import sys,json; nets=json.load(sys.stdin)[0]['NetworkSettings']['Networks']; \
  [print(k, v['IPAddress']) for k,v in nets.items()]"

Forcer un rebuild via l’API Coolify

curl -X GET 'http://[IP_VPS]:8001/api/v1/deploy?uuid=[UUID_APP]&force=true' \
  -H 'Authorization: Bearer [TOKEN_COOLIFY]'

Lister les webhooks Strapi

curl http://strapi.monsite.local/admin/webhooks \
  -H 'Authorization: Bearer [TOKEN_ADMIN]'

Exemple de références à adapter

• Coolify dev : http://[IP_VPS]:8001 — user SSH : [USER]
• Strapi admin : http://strapi.monsite.local/admin
• IP interne Strapi : [IP_INTERNE_STRAPI]:1337 (à vérifier après restart)
• UUID app : [UUID_APP] (récupérable via GET /api/v1/applications)
• Site : http://monsite.local