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

package/docs/id/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Self-Hosting Intlayer
+description: Jalankan instance Intlayer lengkap di infrastruktur Anda sendiri dengan satu perintah. Tidak memerlukan akun Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Self-Hosting Intlayer
+
+Intlayer dapat berjalan sepenuhnya di infrastruktur Anda sendiri — tidak memerlukan akun Intlayer Cloud. Satu perintah akan mem-boot stack yang siap produksi:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Installer mengunduh `docker-compose.yml` dan `.env`, membuat secret yang diperlukan secara otomatis, dan memulai semua kontainer dengan `docker compose up -d`.
+
+## Daftar Isi
+
+<TOC/>
+
+---
+
+## Arsitektur
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+Chromium (digunakan untuk pembuatan screenshot Puppeteer) dibundel di dalam image backend — tidak diperlukan kontainer terpisah.
+
+---
+
+## Prasyarat
+
+- **Docker** ≥ 24 dan **Docker Compose** ≥ v2. Jika salah satunya tidak ada, installer akan mencetak tautan instalasi dan keluar.
+- Port `3000`, `3100`, `8025`, `9000`, dan `9001` tersedia di host.
+- Host Linux atau macOS (atau WSL2 di Windows).
+
+---
+
+## Memulai Cepat
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Apa yang dilakukan installer:
+
+1.  Memeriksa bahwa `docker` dan `docker compose` ada.
+2.  Mengunduh `docker-compose.yml` dan `.env.example` ke `./intlayer/`.
+3.  Jika tidak ada `.env` yang ada, menyalin contoh dan menghasilkan secret acak untuk `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID`, dan `S3_SECRET_ACCESS_KEY` melalui `openssl rand`.
+4.  Menjalankan `docker compose pull` + `docker compose up -d`.
+5.  Mencetak URL: dashboard `:3000`, API `:3100`, UI email `:8025`, konsol MinIO `:9001`.
+
+Setelah stack aktif, buka **http://localhost:3000** dan buat akun pertama Anda.
+
+---
+
+## Layanan
+
+| Layanan     | Image                                 | Port Host                      | Tujuan                                                                  |
+| ----------- | ------------------------------------- | ------------------------------ | ----------------------------------------------------------------------- |
+| **app**     | dibuat dari `apps/app/Dockerfile`     | `3000`                         | Dashboard TanStack Start (UI CMS)                                       |
+| **backend** | dibuat dari `apps/backend/Dockerfile` | `3100`                         | Fastify REST API (`/health` endpoint)                                   |
+| **mongo**   | `mongo:7`                             | internal                       | Replika set node tunggal (`rs0`)                                        |
+| **redis**   | `redis:7-alpine`                      | internal                       | Job queues (BullMQ) dan caching (ioredis)                               |
+| **minio**   | `minio/minio`                         | `9000` (S3), `9001` (konsol)   | Penyimpanan objek yang kompatibel dengan S3 untuk avatar dan screenshot |
+| **mailpit** | `axllent/mailpit`                     | `1025` (SMTP), `8025` (UI web) | Sink email transaksional lokal                                          |
+
+Port internal (mongo, redis) tidak terekspos ke host secara default.
+
+> Port MinIO `9000` harus dapat dijangkau oleh browser karena aset yang diunggah (avatar, screenshot) dimuat langsung dari `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Variabel Lingkungan
+
+Installer menghasilkan `.env` yang siap pakai. Tabel di bawah ini menjelaskan setiap variabel.
+
+### Wajib (dibuat secara otomatis atau diminta)
+
+| Variabel               | Contoh                                          | Deskripsi                                               |
+| ---------------------- | ----------------------------------------------- | ------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Lingkungan runtime                                      |
+| `PORT`                 | `3100`                                          | Port listen backend                                     |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL publik API backend                                  |
+| `APP_URL`              | `http://localhost:3000`                         | URL publik dashboard                                    |
+| `DOMAIN`               | `localhost`                                     | Domain cookie                                           |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI koneksi MongoDB lengkap                             |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL koneksi Redis                                       |
+| `BETTER_AUTH_SECRET`   | _(dibuat)_                                      | Secret 32-byte untuk penandatanganan sesi               |
+| `MAIL_PROVIDER`        | `smtp`                                          | Transportasi mail: `smtp` atau `resend`                 |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Nama host SMTP (nama kontainer Mailpit)                 |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Port SMTP                                               |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Alamat pengirim                                         |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint yang kompatibel dengan S3                      |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL publik untuk pemuatan aset browser                  |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nama bucket                                             |
+| `S3_ACCESS_KEY_ID`     | _(dibuat)_                                      | Kunci akses MinIO                                       |
+| `S3_SECRET_ACCESS_KEY` | _(dibuat)_                                      | Kunci secret MinIO                                      |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL backend yang tertanam di dashboard pada waktu build |
+| `VITE_DOMAIN`          | `localhost`                                     | Domain yang tertanam di dashboard pada waktu build      |
+
+### Opsional (fitur akan menurun secara bertahap jika tidak ada)
+
+| Variabel                                                 | Fitur                                                         |
+| -------------------------------------------------------- | ------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Terjemahan berbantuan AI dan audit konten                     |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Penagihan dan manajemen langganan                             |
+| `RESEND_API_KEY`                                         | Email transaksional via Resend (menimpa Mailpit jika disetel) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Login GitHub OAuth                                            |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Login Google OAuth                                            |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Login GitLab OAuth                                            |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Login Microsoft OAuth                                         |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Login LinkedIn OAuth                                          |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Login Atlassian OAuth                                         |
+
+---
+
+## Menghubungkan proyek Intlayer Anda
+
+Setelah stack berjalan, arahkan proyek Anda ke backend dan dashboard yang di-self-host, bukan ke `intlayer.org`.
+
+### Konfigurasi proyek
+
+```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 dashboard CMS yang di-self-host.
+     * Default: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL API backend yang di-self-host.
+     * Default: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Setel variabel lingkungan di `.env` proyek Anda:
+
+```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>
+```
+
+Buat kredensial akses di dashboard self-host Anda di bawah **Projects → Access keys** di `http://localhost:3000/projects`.
+
+### `@intlayer/api` SDK
+
+Saat menggunakan `@intlayer/api` SDK secara terprogram, teruskan `backendURL` secara eksplisit:
+
+```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();
+```
+
+---
+
+## Peningkatan
+
+Menjalankan ulang installer pada deployment yang ada akan melakukan rolling upgrade:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Ini menarik image terbaru dan memulai ulang kontainer dengan `docker compose pull && docker compose up -d`. Volume yang sudah ada (`mongo-data`, `redis-data`, `minio-data`) dipertahankan — tidak ada kehilangan data.
+
+Untuk meningkatkan secara manual dari dalam direktori `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Cadangkan dan pulihkan
+
+Semua data persisten berada dalam tiga volume Docker bernama.
+
+### Cadangkan
+
+```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
+```
+
+### Pulihkan
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Ulangi untuk redis-data dan minio-data
+```
+
+---
+
+## Menggunakan reverse proxy (Nginx / Caddy)
+
+Untuk deployment produksi, letakkan reverse proxy di depan kontainer aplikasi dan backend daripada mengeksposnya secara langsung.
+
+### Contoh 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;
+    }
+}
+```
+
+Perbarui variabel `.env` berikut agar sesuai dengan domain publik Anda:
+
+```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
+```
+
+> Variabel `VITE_*` tertanam dalam image dashboard pada waktu build. Jika Anda mengubahnya setelah image dibuat, Anda perlu membangun ulang image `app` (`docker compose build app`) atau menggunakan injeksi konfigurasi runtime.
+
+---
+
+## Pemecahan Masalah
+
+### Backend crash-loops pada start pertama
+
+MongoDB dan Redis harus sehat sebelum backend dimulai. File compose menggunakan `depends_on` dengan `condition: service_healthy`. Jika Anda melihat restart backend berulang, periksa apakah `healthchecks` `mongo` dan `redis` lulus:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Dashboard tidak dapat mencapai API
+
+Verifikasi bahwa `VITE_BACKEND_URL` cocok dengan URL di mana backend dapat dijangkau dari **browser** (bukan jaringan Docker). Jika Anda mengubah port backend atau menambahkan reverse proxy, bangun ulang image dashboard:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Email tidak terkirim
+
+Secara default, semua email keluar ditangkap oleh Mailpit. Buka `http://localhost:8025` untuk melihat pesan yang terkirim. Untuk mengirim email sungguhan, setel `MAIL_PROVIDER=resend` dan `RESEND_API_KEY=<your-key>` di `.env`, lalu restart backend:
+
+```sh
+docker compose restart backend
+```
+
+### Bucket MinIO hilang
+
+Jika layanan one-shot `minio-init` tidak berjalan (atau berjalan sebelum MinIO siap), buat bucket secara manual:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Tautan Berguna
+
+- [Dokumentasi Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_CMS.md)
+- [Referensi Konfigurasi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/configuration.md)
+- [SDK CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)

package/docs/it/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-06-30
 title: Intlayer CMS | Esternalizza i tuoi contenuti nel CMS di Intlayer
 description: Esternalizza i tuoi contenuti nel CMS di Intlayer per delegare la gestione dei tuoi contenuti al tuo team.
 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: "Aggiunta sezione Self-Hosting: bootstrap Docker Compose, inventario dei servizi, configurazione SDK, funzionalità opzionali e note di aggiornamento"
   - version: 6.0.1
     date: 2025-09-22
     changes: "Aggiunta documentazione sulla sincronizzazione live"
@@ -373,6 +376,119 @@ Note e vincoli:
 - Il flag `live` viene valutato per ogni dizionario al momento della build. Se il contenuto remoto non era contrassegnato come `live=true` durante la build, è necessario ricostruire per abilitare Live Sync per quel dizionario.
 - Il server di live sync deve poter scrivere nella cartella `.intlayer`. Nei container, assicurarsi che sia garantito l'accesso in scrittura a `/.intlayer`.
 
+## Self-Hosting
+
+Intlayer può essere eseguito interamente sulla propria infrastruttura — nessun account Intlayer Cloud richiesto. Un singolo comando avvia l'intera pila (dashboard, API, database, archiviazione di oggetti ed e-mail) tramite Docker Compose:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Questo scarica un `docker-compose.yml` e un `.env`, genera automaticamente i secret necessari (`BETTER_AUTH_SECRET`, credenziali MinIO) e avvia tutti i container con `docker compose up -d`. Rieseguire lo stesso comando su un'installazione esistente esegue un aggiornamento progressivo senza perdita di dati.
+
+### Servizi avviati
+
+| Servizio            | Porta/e                                 | Scopo                                            |
+| ------------------- | --------------------------------------- | ------------------------------------------------ |
+| **app** (dashboard) | `3000`                                  | Interfaccia CMS TanStack Start                   |
+| **backend** (API)   | `3100`                                  | API REST Fastify                                 |
+| **MongoDB 7**       | interno                                 | Database principale (replica set a nodo singolo) |
+| **Redis 7**         | interno                                 | Code di lavori e caching                         |
+| **MinIO**           | `9000` (S3), `9001` (console)           | Archiviazione di oggetti compatibile S3          |
+| **Mailpit**         | `1025` (SMTP), `8025` (interfaccia web) | Sink locale per e-mail transazionali             |
+
+Chromium (per la generazione di screenshot con Puppeteer) è incluso nell'immagine del backend — non è necessario un container separato.
+
+### Connettere il tuo progetto a un'istanza self-hosted
+
+Punta la tua configurazione Intlayer al tuo backend e dashboard invece di `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 del dashboard CMS self-hosted.
+     * Predefinito: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // es. http://localhost:3000
+
+    /**
+     * URL dell'API backend self-hosted.
+     * Predefinito: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // es. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Imposta le variabili d'ambiente corrispondenti nel tuo progetto:
+
+```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 le credenziali di accesso nel tuo dashboard self-hosted su `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`: puntare a un backend self-hosted
+
+Quando si utilizza l'SDK in modo programmatico, passa `backendURL` esplicitamente a `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();
+```
+
+### Funzionalità opzionali
+
+Queste funzionalità richiedono account esterni e funzionano correttamente anche quando le loro chiavi sono assenti dal `.env` self-hosted:
+
+| Funzionalità                        | Variabile/i d'ambiente                          |
+| ----------------------------------- | ----------------------------------------------- |
+| Traduzione / audit con IA           | `OPENAI_API_KEY`                                |
+| Fatturazione                        | `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 transazionale via Resend     | `RESEND_API_KEY` (predefinito: Mailpit SMTP)    |
+
+### Persistenza dei dati e aggiornamenti
+
+Tre volumi Docker contengono tutto lo stato persistente: `mongo-data`, `redis-data` e `minio-data`. Sopravvivono ai riavvii e agli aggiornamenti dei container. Eseguire nuovamente il programma di installazione scarica le immagini più recenti ed esegue un `docker compose up -d` progressivo.
+
+Porte esposte sull'host:
+
+| Porta  | Servizio                                                             |
+| ------ | -------------------------------------------------------------------- |
+| `3000` | Dashboard                                                            |
+| `3100` | API Backend                                                          |
+| `8025` | Interfaccia web e-mail Mailpit                                       |
+| `9000` | API S3 MinIO (necessaria per il caricamento degli asset nel browser) |
+| `9001` | Console MinIO                                                        |
+
+Per un riferimento completo di tutte le variabili d'ambiente disponibili e le opzioni avanzate (proxy inverso, domini personalizzati, backup/ripristino), consulta la [Guida al Self-Hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md).
+
+---
+
 ## Debug
 
 Se riscontri problemi con il CMS, verifica quanto segue:

package/docs/it/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-06-30
 title: Nuovo Intlayer v9 - Cosa c'è di nuovo?
 description: Scopri le novità di Intlayer v9. Introduzione di package di compatibilità drop-in per le più diffuse librerie i18n e supporto per Collections e Variants.
 keywords:
@@ -9,6 +9,9 @@ keywords:
   - Migrazione
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
@@ -299,13 +302,68 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## SDK CMS: usa Intlayer come database di contenuti headless
+
+Intlayer v9 include un SDK pulito e con autenticazione automatica in `@intlayer/api` per interagire con il CMS in modo programmatico — recuperare progetti, recuperare dizionari e inviarli o aggiornarli dal tuo server, script o CI. L'autenticazione (OAuth2 `client_credentials`) è gestita e rinnovata automaticamente.
+
+L'SDK è suddiviso in **due import separati**, così il tuo bundle include solo i domini che usi davvero:
+
+1. `createIntlayerCMS` — un **autenticatore** leggero che custodisce le credenziali e il token gestito (nessun client di dominio incluso).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **binder di endpoint** per dominio, ciascuno importato dal proprio sottopercorso.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// La configurazione è opzionale: le credenziali ricadono su INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET risolti da `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Lettura
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Scrittura — usa il CMS come un database
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Sicurezza: le credenziali del CMS concedono l'accesso in scrittura ai tuoi contenuti. Crea l'autenticatore sempre **lato server** — non inviare mai `clientId` / `clientSecret` al browser.
+
+---
+
+## Self-Hosting
+
+Intlayer v9 offre supporto di prima classe per eseguire la propria istanza di Intlayer con un singolo comando — nessun account Intlayer Cloud richiesto.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Il programma di installazione scarica un `docker-compose.yml` e un `.env`, genera automaticamente i secret necessari ed esegue `docker compose up -d`. Tutto — il dashboard, l'API, il database, l'archiviazione di oggetti e le email transazionali — viene eseguito localmente nei container.
+
+### Servizi inclusi
+
+| Servizio                                | Scopo                                                                         |
+| --------------------------------------- | ----------------------------------------------------------------------------- |
+| **app** (TanStack Start)                | Interfaccia del dashboard sulla porta `3000`                                  |
+| **backend** (Fastify/Bun)               | API REST sulla porta `3100`                                                   |
+| **MongoDB 7** (single-node replica set) | Database principale                                                           |
+| **Redis 7**                             | Code di lavori e caching                                                      |
+| **MinIO**                               | Archiviazione di oggetti compatibile S3 (avatar, screenshot)                  |
+| **Mailpit**                             | Sink SMTP locale + interfaccia web per email transazionali sulla porta `8025` |
+
+Chromium (utilizzato per la generazione di screenshot con Puppeteer) è incluso nell'immagine del backend — nessun container aggiuntivo necessario.
+
+---
+
 ## Note di migrazione da v8
 
 Se stai eseguendo l'aggiornamento da v8, nota che la v9 non include breaking changes. Ma ecco le modifiche chiave:
 
 - **Compilatore disabilitato per impostazione predefinita**: `compiler.enabled` ora ha come valore predefinito `false`. Se dipendi dall'estrazione dei tuoi file `.content.ts` in fase di build, imposta `compiler.enabled: true` nel tuo `intlayer.config.ts`.
+- **Plugin Vite**: Il compilatore e il proxy di routing locale sono ora integrati in `intlayer()`. Se in precedenza hai registrato `intlayerCompiler()` o `intlayerProxy()` manualmente, puoi rimuoverli — vengono deduplicati automaticamente, quindi mantenerli è innocuo. Usa `routing.enableProxy: false` per disattivare il proxy.
 - **Locales & Dialects**: Se utilizzi dipendenze i18n esterne, aggiungi i rispettivi compat adapter plugin nella tua configurazione o setup del bundler per riscrivere automaticamente gli import.
 - **Custom Selectors**: Quando chiami `useIntlayer`, il secondo parametro è ora riservato a un oggetto di opzioni contenente `{ locale, item, variant }`. Se in precedenza passavi direttamente una stringa locale, puoi ancora farlo, ma l'utilizzo dell'oggetto di opzioni è consigliato per selezioni avanzate.
+- **React Native**: `react-native-intlayer` ora riesporta l'intera API di `react-intlayer`. In un'app React Native, importa tutto da `react-native-intlayer` e rimuovi la dipendenza diretta da `react-intlayer`. Gli import esistenti di `react-intlayer` continuano a funzionare.
 
 ---
 
@@ -314,3 +372,5 @@ Se stai eseguendo l'aggiornamento da v8, nota che la v9 non include breaking cha
 - [Guida ai Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md)
 - [Dizionari Dinamici - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md)
 - [Riferimento alla Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)
+- [SDK CMS - Accesso programmatico con @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
+- [Guida al Self-Hosting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/self_hosting.md)