@intlayer/docs 9.0.0-canary.10 → 9.0.0-canary.11

package/docs/es/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Autoalojamiento de Intlayer
+description: Ejecuta una instancia completa de Intlayer en tu propia infraestructura con un solo comando. No se requiere una cuenta de Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Autoalojamiento de Intlayer
+
+Intlayer puede ejecutarse completamente en tu propia infraestructura, sin necesidad de una cuenta de Intlayer Cloud. Un solo comando inicia una pila lista para producción:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+El instalador descarga un `docker-compose.yml` y un `.env`, autogenera los secretos necesarios e inicia todos los contenedores con `docker compose up -d`.
+
+## Tabla de Contenidos
+
+<TOC/>
+
+---
+
+## Arquitectura
+
+```
+                ┌─────────────────────────────┐
+ navegador ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (RS de 1 nodo)             (API de S3)     (SMTP)        (en-imagen)
+                             minio:9001   mailpit:8025
+                             (consola)    (interfaz web)
+```
+
+Chromium (utilizado para la generación de capturas de pantalla de Puppeteer) se incluye dentro de la imagen del backend, no se necesita un contenedor separado.
+
+---
+
+## Requisitos previos
+
+- **Docker** ≥ 24 y **Docker Compose** ≥ v2. Si falta alguno, el instalador imprimirá el enlace de instalación y saldrá.
+- Puertos `3000`, `3100`, `8025`, `9000` y `9001` disponibles en el host.
+- Un host Linux o macOS (o WSL2 en Windows).
+
+---
+
+## Inicio rápido
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Lo que hace el instalador:
+
+1.  Verifica que `docker` y `docker compose` estén presentes.
+2.  Descarga `docker-compose.yml` y `.env.example` en `./intlayer/`.
+3.  Si no existe un `.env`, copia el ejemplo y genera secretos aleatorios para `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` y `S3_SECRET_ACCESS_KEY` a través de `openssl rand`.
+4.  Ejecuta `docker compose pull` + `docker compose up -d`.
+5.  Imprime las URLs: dashboard `:3000`, API `:3100`, interfaz de usuario de correo electrónico `:8025`, consola de MinIO `:9001`.
+
+Una vez que la pila esté en funcionamiento, abre **http://localhost:3000** y crea tu primera cuenta.
+
+---
+
+## Servicios
+
+| Servicio    | Imagen                                     | Puerto(s) del host                   | Propósito                                                                        |
+| :---------- | :----------------------------------------- | :----------------------------------- | :------------------------------------------------------------------------------- |
+| **app**     | construido desde `apps/app/Dockerfile`     | `3000`                               | Dashboard de TanStack Start (UI del CMS)                                         |
+| **backend** | construido desde `apps/backend/Dockerfile` | `3100`                               | API REST de Fastify (endpoint `/health`)                                         |
+| **mongo**   | `mongo:7`                                  | interno                              | Conjunto de réplicas de un solo nodo (`rs0`)                                     |
+| **redis**   | `redis:7-alpine`                           | interno                              | Colas de trabajos (BullMQ) y almacenamiento en caché (ioredis)                   |
+| **minio**   | `minio/minio`                              | `9000` (S3), `9001` (consola)        | Almacenamiento de objetos compatible con S3 para avatares y capturas de pantalla |
+| **mailpit** | `axllent/mailpit`                          | `1025` (SMTP), `8025` (interfaz web) | Receptor local de correos electrónicos transaccionales                           |
+
+Los puertos internos (mongo, redis) no se exponen al host por defecto.
+
+> El puerto `9000` de MinIO debe ser accesible desde el navegador porque los activos cargados (avatares, capturas de pantalla) se cargan directamente desde `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Variables de entorno
+
+El instalador genera un archivo `.env` listo para usar. La siguiente tabla describe cada variable.
+
+### Requeridas (autogeneradas o solicitadas)
+
+| Variable               | Ejemplo                                         | Descripción                                                         |
+| :--------------------- | :---------------------------------------------- | :------------------------------------------------------------------ |
+| `NODE_ENV`             | `production`                                    | Entorno de ejecución                                                |
+| `PORT`                 | `3100`                                          | Puerto de escucha del backend                                       |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL pública de la API del backend                                   |
+| `APP_URL`              | `http://localhost:3000`                         | URL pública del dashboard                                           |
+| `DOMAIN`               | `localhost`                                     | Dominio de la cookie                                                |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI de conexión completa de MongoDB                                 |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL de conexión de Redis                                            |
+| `BETTER_AUTH_SECRET`   | _(generado)_                                    | Secreto de 32 bytes para la firma de sesiones                       |
+| `MAIL_PROVIDER`        | `smtp`                                          | Transporte de correo: `smtp` o `resend`                             |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Nombre de host SMTP (nombre del contenedor de Mailpit)              |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Puerto SMTP                                                         |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Dirección del remitente                                             |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint compatible con S3                                          |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL pública para la carga de activos del navegador                  |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nombre del bucket                                                   |
+| `S3_ACCESS_KEY_ID`     | _(generado)_                                    | Clave de acceso de MinIO                                            |
+| `S3_SECRET_ACCESS_KEY` | _(generado)_                                    | Clave secreta de MinIO                                              |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL del backend integrada en el dashboard en tiempo de construcción |
+| `VITE_DOMAIN`          | `localhost`                                     | Dominio integrado en el dashboard en tiempo de construcción         |
+
+### Opcionales (las características se degradan elegantemente cuando están ausentes)
+
+| Variable                                                 | Característica                                                                          |
+| :------------------------------------------------------- | :-------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Traducción asistida por IA y auditoría de contenido                                     |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Gestión de facturación y suscripciones                                                  |
+| `RESEND_API_KEY`                                         | Correo electrónico transaccional a través de Resend (anula Mailpit cuando se configura) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Inicio de sesión GitHub OAuth                                                           |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Inicio de sesión Google OAuth                                                           |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Inicio de sesión GitLab OAuth                                                           |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Inicio de sesión Microsoft OAuth                                                        |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Inicio de sesión LinkedIn OAuth                                                         |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Inicio de sesión Atlassian OAuth                                                        |
+
+---
+
+## Conectando tu proyecto Intlayer
+
+Una vez que la pila esté en funcionamiento, apunta tu proyecto al backend y dashboard autoalojados en lugar de `intlayer.org`.
+
+### Configuración del proyecto
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL del dashboard CMS autoalojado.
+     * Por defecto: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL de la API del backend autoalojado.
+     * Por defecto: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Establece las variables de entorno en el `.env` de tu proyecto:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Crea credenciales de acceso en tu dashboard autoalojado en **Proyectos → Claves de acceso** en `http://localhost:3000/projects`.
+
+### SDK de `@intlayer/api`
+
+Al usar el SDK de `@intlayer/api` programáticamente, pasa `backendURL` explícitamente:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Actualización
+
+Volver a ejecutar el instalador en un despliegue existente realiza una actualización continua:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Esto descarga las últimas imágenes y reinicia los contenedores con `docker compose pull && docker compose up -d`. Los volúmenes existentes (`mongo-data`, `redis-data`, `minio-data`) se conservan, sin pérdida de datos.
+
+Para actualizar manualmente desde el directorio `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Copia de seguridad y restauración
+
+Todos los datos persistentes residen en tres volúmenes de Docker con nombre.
+
+### Copia de seguridad
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Restauración
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Repetir para redis-data y minio-data
+```
+
+---
+
+## Uso de un proxy inverso (Nginx / Caddy)
+
+Para despliegues de producción, coloca un proxy inverso delante de los contenedores de la aplicación y del backend en lugar de exponerlos directamente.
+
+### Ejemplo de Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Actualiza las siguientes variables `.env` para que coincidan con tus dominios públicos:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Las variables `VITE_*` se integran en la imagen del dashboard en el momento de la construcción. Si las cambias después de que se construya la imagen, necesitas reconstruir la imagen de la `app` (`docker compose build app`) o usar la inyección de configuración en tiempo de ejecución.
+
+---
+
+## Solución de problemas
+
+### Reinicios del backend en bucle al inicio
+
+MongoDB y Redis deben estar saludables antes de que el backend se inicie. El archivo compose utiliza `depends_on` con `condition: service_healthy`. Si ves reinicios repetidos del backend, verifica que los healthchecks de `mongo` y `redis` pasen:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### El dashboard no puede conectar con la API
+
+Verifica que `VITE_BACKEND_URL` coincida con la URL donde el backend es accesible desde el **navegador** (no desde la red de Docker). Si cambiaste el puerto del backend o añadiste un proxy inverso, reconstruye la imagen del dashboard:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### El correo electrónico no se envía
+
+Por defecto, todos los correos electrónicos salientes son capturados por Mailpit. Abre `http://localhost:8025` para ver los mensajes enviados. Para enviar correos electrónicos reales, establece `MAIL_PROVIDER=resend` y `RESEND_API_KEY=<tu-clave>` en `.env`, luego reinicia el backend:
+
+```sh
+docker compose restart backend
+```
+
+### Falta el bucket de MinIO
+
+Si el servicio de un solo uso `minio-init` no se ejecutó (o se ejecutó antes de que MinIO estuviera listo), crea el bucket manualmente:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Enlaces útiles
+
+- [Documentación del CMS de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)
+- [Referencia de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md)
+- [SDK del CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md#programmatic-access-con-el-sdk-intlayerapi)

package/docs/fr/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-06-30
 title: Intlayer CMS | Externalisez votre contenu dans le CMS Intlayer
 description: Externalisez votre contenu dans le CMS Intlayer pour déléguer la gestion de votre contenu à votre équipe.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-06-30
+    changes: "Ajout de la section Auto-hébergement : bootstrap Docker Compose, inventaire des services, configuration SDK, fonctionnalités optionnelles et notes de mise à niveau"
   - version: 6.0.1
     date: 2025-09-22
     changes: "Ajout de la documentation sur la synchronisation en direct"
@@ -380,6 +383,119 @@ Notes et contraintes :
 - L'indicateur `live` est évalué pour chaque dictionnaire au moment de la compilation. Si le contenu distant n'était pas marqué `live=true` lors de la compilation, vous devez recompiler pour activer la synchronisation en direct pour ce dictionnaire.
 - Le serveur de synchronisation en direct doit pouvoir écrire dans `.intlayer`. Dans les conteneurs, assurez-vous d'avoir un accès en écriture à `/.intlayer`.
 
+## Auto-hébergement
+
+Intlayer peut fonctionner entièrement sur votre propre infrastructure — aucun compte Intlayer Cloud requis. Une seule commande amorce l'ensemble de la pile (tableau de bord, API, base de données, stockage d'objets et e-mail) avec Docker Compose :
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Cela télécharge un `docker-compose.yml` et un `.env`, génère automatiquement les secrets requis (`BETTER_AUTH_SECRET`, identifiants MinIO) et démarre tous les conteneurs avec `docker compose up -d`. Relancer la même commande sur une installation existante effectue une mise à niveau progressive sans perte de données.
+
+### Services démarrés
+
+| Service                   | Port(s)                               | Objectif                                           |
+| ------------------------- | ------------------------------------- | -------------------------------------------------- |
+| **app** (tableau de bord) | `3000`                                | Interface CMS TanStack Start                       |
+| **backend** (API)         | `3100`                                | API REST Fastify                                   |
+| **MongoDB 7**             | interne                               | Base de données principale (replica set mono-nœud) |
+| **Redis 7**               | interne                               | Files d'attente de tâches et mise en cache         |
+| **MinIO**                 | `9000` (S3), `9001` (console)         | Stockage d'objets compatible S3                    |
+| **Mailpit**               | `1025` (SMTP), `8025` (interface web) | Puits d'e-mails transactionnels local              |
+
+Chromium (pour la génération de captures d'écran Puppeteer) est intégré dans l'image du backend — aucun conteneur séparé n'est nécessaire.
+
+### Connecter votre projet à une instance auto-hébergée
+
+Pointez votre configuration Intlayer vers votre propre backend et tableau de bord au lieu de `intlayer.org` :
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL du tableau de bord CMS auto-hébergé.
+     * Par défaut : https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // ex. http://localhost:3000
+
+    /**
+     * URL de l'API backend auto-hébergée.
+     * Par défaut : https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // ex. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Définissez les variables d'environnement correspondantes dans votre projet :
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Créez des identifiants d'accès dans votre tableau de bord auto-hébergé à `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api` : pointer vers un backend auto-hébergé
+
+Lors de l'utilisation du SDK de manière programmatique, passez `backendURL` explicitement à `createIntlayerCMS` :
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+### Fonctionnalités optionnelles
+
+Ces fonctionnalités nécessitent des comptes externes et fonctionnent normalement même sans leurs clés dans le fichier `.env` auto-hébergé :
+
+| Fonctionnalité                      | Variable(s) d'environnement                     |
+| ----------------------------------- | ----------------------------------------------- |
+| Traduction / audit par IA           | `OPENAI_API_KEY`                                |
+| Facturation                         | `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, … |
+| OAuth GitHub                        | `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`      |
+| OAuth Google                        | `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`      |
+| OAuth GitLab / Microsoft / LinkedIn | `GITLAB_*`, `MICROSOFT_*`, `LINKEDIN_*`         |
+| E-mail transactionnel via Resend    | `RESEND_API_KEY` (par défaut : Mailpit SMTP)    |
+
+### Persistance des données et mises à niveau
+
+Trois volumes Docker contiennent tout l'état persistant : `mongo-data`, `redis-data` et `minio-data`. Ils survivent aux redémarrages et aux mises à niveau des conteneurs. Relancer le programme d'installation télécharge les dernières images et effectue un `docker compose up -d` progressif.
+
+Ports exposés sur l'hôte :
+
+| Port   | Service                                                                 |
+| ------ | ----------------------------------------------------------------------- |
+| `3000` | Tableau de bord                                                         |
+| `3100` | API Backend                                                             |
+| `8025` | Interface web Mailpit                                                   |
+| `9000` | API S3 MinIO (requise pour le chargement des assets dans le navigateur) |
+| `9001` | Console MinIO                                                           |
+
+Pour une référence complète de toutes les variables d'environnement disponibles et des options avancées (proxy inverse, domaines personnalisés, sauvegarde/restauration), consultez le [Guide d'auto-hébergement](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/self_hosting.md).
+
+---
+
 ## Débogage
 
 Si vous rencontrez des problèmes avec le CMS, vérifiez les points suivants :

package/docs/fr/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-06-30
 title: Nouvel Intlayer v9 - Quoi de neuf ?
 description: Découvrez les nouveautés d'Intlayer v9. Présentation des packages de compatibilité prêts à l'emploi pour les bibliothèques i18n populaires et prise en charge des Collections et Variants.
 keywords:
@@ -9,6 +9,9 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
@@ -295,13 +298,68 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## SDK CMS : utilisez Intlayer comme une base de données de contenu headless
+
+Intlayer v9 fournit un SDK clair et auto-authentifié dans `@intlayer/api` pour interagir avec le CMS de manière programmatique — récupérer des projets, récupérer des dictionnaires, et les pousser ou les mettre à jour depuis votre propre serveur, vos scripts ou votre CI. L'authentification (OAuth2 `client_credentials`) est gérée et rafraîchie pour vous.
+
+Le SDK est divisé en **deux imports distincts** afin que votre bundle n'inclue que les domaines que vous utilisez réellement :
+
+1. `createIntlayerCMS` — un **authentificateur** léger qui détient les identifiants et le jeton géré (aucun client de domaine n'est inclus).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — des **lieurs d'endpoint** par domaine, chacun importé depuis son propre sous-chemin.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// La configuration est optionnelle : les identifiants reviennent à INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET résolus par `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Lecture
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Écriture — utilisez le CMS comme une base de données
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Sécurité : les identifiants du CMS accordent un accès en écriture à votre contenu. Créez toujours l'authentificateur **côté serveur** uniquement — n'envoyez jamais `clientId` / `clientSecret` au navigateur.
+
+---
+
+## Auto-hébergement
+
+Intlayer v9 offre une prise en charge de première classe pour exécuter votre propre instance Intlayer avec une seule commande — aucun compte Intlayer Cloud requis.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Le programme d'installation télécharge un `docker-compose.yml` et un `.env`, génère automatiquement les secrets requis et exécute `docker compose up -d`. Tout — le tableau de bord, l'API, la base de données, le stockage d'objets et les e-mails transactionnels — s'exécute localement dans des conteneurs.
+
+### Services inclus
+
+| Service                                 | Objectif                                                                             |
+| --------------------------------------- | ------------------------------------------------------------------------------------ |
+| **app** (TanStack Start)                | Interface du tableau de bord sur le port `3000`                                      |
+| **backend** (Fastify/Bun)               | API REST sur le port `3100`                                                          |
+| **MongoDB 7** (single-node replica set) | Base de données principale                                                           |
+| **Redis 7**                             | Files d'attente de tâches et mise en cache                                           |
+| **MinIO**                               | Stockage d'objets compatible S3 (avatars, captures d'écran)                          |
+| **Mailpit**                             | Puits SMTP local + interface web pour les e-mails transactionnels sur le port `8025` |
+
+Chromium (utilisé pour la génération de captures d'écran Puppeteer) est intégré dans l'image du backend — aucun conteneur supplémentaire n'est nécessaire.
+
+---
+
 ## Notes de migration depuis la v8
 
 Si vous effectuez une mise à niveau depuis la v8, notez que la v9 n'inclut pas de changements majeurs (breaking changes). Voici cependant les changements clés :
 
 - **Compilateur désactivé par défaut** : `compiler.enabled` vaut désormais `false` par défaut. Si vous dépendez de l'extraction de vos fichiers `.content.ts` au build, définissez `compiler.enabled: true` dans votre `intlayer.config.ts`.
+- **Plugin Vite** : Le compilateur et le proxy de routage de locale sont désormais intégrés dans `intlayer()`. Si vous avez précédemment enregistré `intlayerCompiler()` ou `intlayerProxy()` manuellement, vous pouvez les supprimer — ils sont dédupliqués automatiquement, donc les conserver est sans danger. Utilisez `routing.enableProxy: false` pour désactiver le proxy.
 - **Locales et dialectes** : Si vous utilisez des dépendances i18n externes, ajoutez leurs plugins d'adaptateur de compatibilité respectifs dans votre configuration ou votre setup de bundler pour réécrire automatiquement les imports.
 - **Sélecteurs personnalisés** : Lors de l'appel de `useIntlayer`, le deuxième paramètre est désormais réservé à un objet d'options contenant `{ locale, item, variant }`. Si vous passiez auparavant une chaîne de caractères de locale directement, vous pouvez toujours le faire, mais l'utilisation de l'objet d'options est recommandée pour les sélections avancées.
+- **React Native** : `react-native-intlayer` réexporte désormais l'intégralité de l'API `react-intlayer`. Dans une application React Native, importez tout depuis `react-native-intlayer` et supprimez la dépendance directe à `react-intlayer`. Les imports `react-intlayer` existants continuent de fonctionner.
 
 ---
 
@@ -310,3 +368,5 @@ Si vous effectuez une mise à niveau depuis la v8, notez que la v9 n'inclut pas
 - [Guide des packages d'adaptateurs de compatibilité](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compat/index.md)
 - [Dictionnaires dynamiques - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/index.md)
 - [Référence de configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md)
+- [SDK CMS - Accès programmatique avec @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md)
+- [Guide d'auto-hébergement](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/self_hosting.md)