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

package/docs/it/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Self-Hosting Intlayer
+description: Esegui un'istanza Intlayer completa sulla tua infrastruttura con un singolo comando. Non è richiesto alcun account Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Self-Hosting Intlayer
+
+Intlayer può essere eseguito interamente sulla tua infrastruttura — non è richiesto alcun account Intlayer Cloud. Un singolo comando avvia uno stack pronto per la produzione:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+L'installer scarica un `docker-compose.yml` e un `.env`, genera automaticamente i segreti richiesti e avvia tutti i container con `docker compose up -d`.
+
+## Indice dei Contenuti
+
+<TOC/>
+
+---
+
+## Architettura
+
+```
+                ┌─────────────────────────────┐
+ 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 (utilizzato per la generazione di screenshot con Puppeteer) è incluso nell'immagine del backend — non è necessario un container separato.
+
+---
+
+## Prerequisiti
+
+- **Docker** ≥ 24 e **Docker Compose** ≥ v2. Se uno dei due manca, l'installer stampa il link di installazione ed esce.
+- Porte `3000`, `3100`, `8025`, `9000` e `9001` disponibili sull'host.
+- Un host Linux o macOS (o WSL2 su Windows).
+
+---
+
+## Avvio rapido
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Cosa fa l'installer:
+
+1.  Verifica che `docker` e `docker compose` siano presenti.
+2.  Scarica `docker-compose.yml` e `.env.example` in `./intlayer/`.
+3.  Se non esiste un `.env`, copia l'esempio e genera segreti casuali per `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` e `S3_SECRET_ACCESS_KEY` tramite `openssl rand`.
+4.  Esegue `docker compose pull` + `docker compose up -d`.
+5.  Stampa gli URL: dashboard `:3000`, API `:3100`, interfaccia utente email `:8025`, console MinIO `:9001`.
+
+Dopo che lo stack è attivo, apri **http://localhost:3000** e crea il tuo primo account.
+
+---
+
+## Servizi
+
+| Servizio    | Immagine                             | Porta/e host                   | Scopo                                                         |
+| ----------- | ------------------------------------ | ------------------------------ | ------------------------------------------------------------- |
+| **app**     | built from `apps/app/Dockerfile`     | `3000`                         | Dashboard TanStack Start (UI del CMS)                         |
+| **backend** | built from `apps/backend/Dockerfile` | `3100`                         | API REST Fastify (endpoint `/health`)                         |
+| **mongo**   | `mongo:7`                            | internal                       | Replica set a nodo singolo (`rs0`)                            |
+| **redis**   | `redis:7-alpine`                     | internal                       | Code di lavoro (BullMQ) e caching (ioredis)                   |
+| **minio**   | `minio/minio`                        | `9000` (S3), `9001` (console)  | Storage di oggetti compatibile con S3 per avatar e screenshot |
+| **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (web UI) | Sink di email transazionali locale                            |
+
+Le porte interne (mongo, redis) non sono esposte all'host per impostazione predefinita.
+
+> La porta `9000` di MinIO deve essere raggiungibile dal browser perché gli asset caricati (avatar, screenshot) vengono caricati direttamente da `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Variabili d'ambiente
+
+L'installer genera un `.env` pronto all'uso. La tabella seguente descrive ogni variabile.
+
+### Obbligatorie (generate automaticamente o richieste)
+
+| Variabile              | Esempio                                         | Descrizione                                                             |
+| ---------------------- | ----------------------------------------------- | ----------------------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Ambiente di runtime                                                     |
+| `PORT`                 | `3100`                                          | Porta di ascolto del backend                                            |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL pubblico dell'API del backend                                       |
+| `APP_URL`              | `http://localhost:3000`                         | URL pubblico della dashboard                                            |
+| `DOMAIN`               | `localhost`                                     | Dominio del cookie                                                      |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI di connessione completo di MongoDB                                  |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL di connessione di Redis                                             |
+| `BETTER_AUTH_SECRET`   | _(generated)_                                   | Segreto di 32 byte per la firma della sessione                          |
+| `MAIL_PROVIDER`        | `smtp`                                          | Trasporto email: `smtp` o `resend`                                      |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Hostname SMTP (nome del container Mailpit)                              |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Porta SMTP                                                              |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Indirizzo del mittente                                                  |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint compatibile con S3                                             |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL pubblico per il caricamento degli asset del browser                 |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nome del bucket                                                         |
+| `S3_ACCESS_KEY_ID`     | _(generated)_                                   | Chiave di accesso MinIO                                                 |
+| `S3_SECRET_ACCESS_KEY` | _(generated)_                                   | Chiave segreta MinIO                                                    |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL del backend integrato nella dashboard al momento della compilazione |
+| `VITE_DOMAIN`          | `localhost`                                     | Dominio integrato nella dashboard al momento della compilazione         |
+
+### Opzionali (le funzionalità degradano elegantemente se assenti)
+
+| Variabile                                                | Funzionalità                                                              |
+| -------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Traduzione assistita da AI e audit del contenuto                          |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Gestione della fatturazione e degli abbonamenti                           |
+| `RESEND_API_KEY`                                         | Email transazionali tramite Resend (sostituisce Mailpit quando impostato) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Accesso OAuth di GitHub                                                   |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Accesso OAuth di Google                                                   |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Accesso OAuth di GitLab                                                   |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Accesso OAuth di Microsoft                                                |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Accesso OAuth di LinkedIn                                                 |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Accesso OAuth di Atlassian                                                |
+
+---
+
+## Collegamento del tuo progetto Intlayer
+
+Una volta che lo stack è in esecuzione, punta il tuo progetto al backend e alla dashboard self-hosted invece di `intlayer.org`.
+
+### Configurazione del progetto
+
+```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 della dashboard CMS self-hosted.
+     * Predefinito: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL dell'API del backend self-hosted.
+     * Predefinito: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Imposta le variabili d'ambiente nel `.env` del 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 nella tua dashboard self-hosted sotto **Progetti → Chiavi di accesso** all'indirizzo `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+Quando si utilizza l'SDK `@intlayer/api` in modo programmatico, passa `backendURL` esplicitamente:
+
+```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();
+```
+
+---
+
+## Aggiornamento
+
+Eseguire nuovamente l'installer su un'implementazione esistente esegue un aggiornamento rolling:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Questo scarica le immagini più recenti e riavvia i container con `docker compose pull && docker compose up -d`. I volumi esistenti (`mongo-data`, `redis-data`, `minio-data`) vengono preservati — nessuna perdita di dati.
+
+Per aggiornare manualmente dalla directory `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Backup e ripristino
+
+Tutti i dati persistenti risiedono in tre volumi Docker nominati.
+
+### Backup
+
+```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
+```
+
+### Ripristino
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Ripetere per redis-data e minio-data
+```
+
+---
+
+## Utilizzo di un reverse proxy (Nginx / Caddy)
+
+Per le implementazioni in produzione, posiziona un reverse proxy davanti ai container dell'app e del backend invece di esporli direttamente.
+
+### Esempio 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;
+    }
+}
+```
+
+Aggiorna le seguenti variabili `.env` per corrispondere ai tuoi domini pubblici:
+
+```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
+```
+
+> Le variabili `VITE_*` sono integrate nell'immagine della dashboard al momento della compilazione. Se le modifichi dopo che l'immagine è stata compilata, devi ricostruire l'immagine `app` (`docker compose build app`) o utilizzare l'iniezione della configurazione a runtime.
+
+---
+
+## Risoluzione dei problemi
+
+### Il backend si riavvia in loop al primo avvio
+
+MongoDB e Redis devono essere sani prima che il backend si avvii. Il file compose utilizza `depends_on` con `condition: service_healthy`. Se vedi ripetuti riavvii del backend, verifica che i controlli di integrità di `mongo` e `redis` passino:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### La dashboard non riesce a raggiungere l'API
+
+Verifica che `VITE_BACKEND_URL` corrisponda all'URL dove il backend è raggiungibile dal **browser** (non dalla rete Docker). Se hai cambiato la porta del backend o aggiunto un reverse proxy, ricostruisci l'immagine della dashboard:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Email non inviate
+
+Per impostazione predefinita, tutte le email in uscita vengono catturate da Mailpit. Apri `http://localhost:8025` per vedere i messaggi inviati. Per inviare email reali, imposta `MAIL_PROVIDER=resend` e `RESEND_API_KEY=<la-tua-chiave>` in `.env`, quindi riavvia il backend:
+
+```sh
+docker compose restart backend
+```
+
+### Bucket MinIO mancante
+
+Se il servizio one-shot `minio-init` non è stato eseguito (o è stato eseguito prima che MinIO fosse pronto), crea il bucket manualmente:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Link utili
+
+- [Documentazione Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
+- [Riferimento alla configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)
+- [SDK CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md#programmatic-access-con-l-sdk-intlayerapi)

package/docs/ja/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-06-29
 title: Intlayer CMS | コンテンツをIntlayer CMSに外部化する
 description: コンテンツ管理をチームに委任するために、コンテンツをIntlayer CMSに外部化します。
 keywords:
@@ -18,6 +18,12 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-06-30
+    changes: "「セルフホスティング」セクションを追加: Docker Composeブートストラップ、サービスインベントリ、SDK設定、オプション機能、アップグレードノート"
+  - version: 9.0.0
+    date: 2026-06-29
+    changes: "プログラムによるCMSアクセスに関する @intlayer/api SDK (createIntlayerCMS) セクションを追加"
   - version: 6.0.1
     date: 2025-09-22
     changes: "ライブ同期のドキュメントを追加"
@@ -241,12 +247,162 @@ bun x intlayer dictionary push -d my-first-dictionary-key --env production
 
 その後、[Intlayer CMS](https://app.intlayer.org/content) で辞書を確認および管理できるようになります。
 
+## `@intlayer/api` SDK を使用したプログラムによるアクセス
+
+CLI およびビジュアルエディターを超えて、Intlayer は [`@intlayer/api`](https://www.npmjs.com/package/@intlayer/api) パッケージで型付き SDK を提供しています。これにより、CMS を**ヘッドレスコンテンツデータベース**として扱うことができます。プロジェクトの取得、辞書の取得、および独自のアプリケーション、スクリプト、または CI パイプラインから直接、それらをプッシュまたは更新できます。
+
+SDK は認証を処理します。`clientId` と `clientSecret` が利用可能であれば（Intlayer の設定または環境変数で）、OAuth2 アクセストークンを自動的に取得および更新し、すべてのリクエストに署名します。
+
+### インストール
+
+```bash packageManager="npm"
+npm install @intlayer/api
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/api
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/api
+```
+
+```bash packageManager="bun"
+bun add @intlayer/api
+```
+
+### 仕組み: オーセンティケーター + エンドポイント
+
+SDK は、バンドルサイズを小さくするために、意図的に**2つの別々のインポート**に分割されています。
+
+1.  `createIntlayerCMS` — 軽量な**オーセンティケーター**を作成します。これは認証情報と管理されたアクセストークンのみを保持し、特定のドメインについては何も知りません。
+2.  `dictionaryEndpoint`、`projectEndpoint`、… — ドメインごとの**エンドポイントバインダー**で、それぞれ独自のサブパス（`@intlayer/api/dictionary`、`@intlayer/api/project`、…）からインポートされます。必要なエンドポイントにオーセンティケーターを渡します。
+
+各エンドポイントは個別にインポートされるため、バンドルには実際に使用するドメインのみが含まれます。`dictionaryEndpoint` をインポートしても、プロジェクト、AI、その他のドメインクライアントがプルインされることはありません。
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+
+// 設定はオプションです: 省略した場合、認証情報は
+// `@intlayer/config/built` から読み込まれます。これは INTLAYER_CLIENT_ID および
+// INTLAYER_CLIENT_SECRET 環境変数を解決します。
+export const cmsAuthenticator = createIntlayerCMS();
+```
+
+> [!WARNING]
+> CMS の認証情報 (`clientId` / `clientSecret`) はコンテンツへの**書き込みアクセス**を許可します。オーセンティケーターは**サーバー側**（サーバーアクション、ルートハンドラー、スクリプト、CI）でのみ作成してください。クライアント側コードにインポートしたり、認証情報をブラウザに公開したりしないでください。
+
+ビルド時の設定に依存しない場合は、認証情報を明示的に渡します。
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+
+export const cmsAuthenticator = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    // オプション、セルフホスティングされたバックエンドの場合:
+    // backendURL: process.env.INTLAYER_BACKEND_URL,
+  },
+});
+```
+
+> 認証情報は、[Intlayer Dashboard - Projects](https://app.intlayer.org/projects) で新しいアクセスキーを作成して取得できます。
+
+### プロジェクトの取得
+
+```typescript fileName="projects.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { projectEndpoint } from "@intlayer/api/project";
+
+const cmsAuthenticator = createIntlayerCMS();
+
+// 認証情報でアクセス可能なプロジェクトをリストアップ
+const { data: projects } =
+  await projectEndpoint(cmsAuthenticator).getProjects();
+
+// 選択したプロジェクトの集約されたローカライゼーションインサイトを読み取る
+const { data: insights } =
+  await projectEndpoint(cmsAuthenticator).getProjectInsights();
+```
+
+### 辞書の取得
+
+```typescript fileName="read-dictionaries.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cmsAuthenticator = createIntlayerCMS();
+
+// プロジェクトのすべてのリモート辞書をリストアップ
+const { data: dictionaries } =
+  await dictionaryEndpoint(cmsAuthenticator).getDictionaries();
+
+// またはキーで単一の辞書を取得
+const { data: dictionary } = await dictionaryEndpoint(
+  cmsAuthenticator
+).getDictionary("my-first-dictionary-key");
+```
+
+### 辞書のプッシュと更新
+
+CMS をデータベースとして使用してコンテンツを書き戻します。
+
+```typescript fileName="write-dictionaries.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cmsAuthenticator = createIntlayerCMS();
+
+// 新しい辞書を作成
+await dictionaryEndpoint(cmsAuthenticator).addDictionary({
+  key: "my-first-dictionary-key",
+  content: { title: "Hello world" },
+});
+
+// 辞書の一括Upsert (1回の呼び出しで作成または更新)
+await dictionaryEndpoint(cmsAuthenticator).pushDictionaries([
+  { key: "home", content: { title: "Home" } },
+  { key: "about", content: { title: "About" } },
+]);
+
+// 既存の辞書を更新
+await dictionaryEndpoint(cmsAuthenticator).updateDictionary({
+  id: "<dictionary-id>",
+  key: "home",
+  content: { title: "Updated title" },
+});
+```
+
+> ヒント: 繰り返しを避けるためにバインドされたエンドポイントを再利用します。
+>
+> ```typescript codeFormat="typescript"
+> const dictionary = dictionaryEndpoint(cmsAuthenticator);
+> await dictionary.pushDictionaries([myDictionary]);
+> const { data } = await dictionary.getDictionaries();
+> ```
+
+### 単一メソッドの抽出
+
+すべてのエンドポイントメソッドはすでに認証されており、スタンドアロンであるため（独自のトークン処理を保持しているため）、1つを抽出して渡すことができます。例えば、依存関係として注入する場合などです。
+
+```typescript fileName="push.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const dictionary = dictionaryEndpoint(createIntlayerCMS());
+
+// すでに認証済み — 呼び出しごとに自動的にトークンを更新します
+export const pushDictionaries = dictionary.pushDictionaries;
+
+// 使用方法
+await pushDictionaries([{ key: "home", content: { title: "Home" } }]);
+```
+
 ## ライブ同期
 
 ライブ同期は、アプリが実行時に CMS のコンテンツ変更を反映できるようにします。再ビルドや再デプロイは不要です。有効にすると、更新がライブ同期サーバーにストリームされ、アプリケーションが読み込む辞書が更新されます。
 
-> Live Syncは継続的なサーバー接続を必要とし、エンタープライズプランで利用可能です。
-
 Intlayerの設定を更新してLive Syncを有効にします：
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
@@ -271,7 +427,7 @@ const config: IntlayerConfig = {
     /**
      * 辞書のインポート方法を制御します：
      *
-     * - "live"：辞書はLive Sync APIを使用して動的に取得されます。
+     * - "fetch"：辞書はLive Sync APIを使用して動的に取得されます。
      *   useIntlayerの代わりにuseDictionaryDynamicを使用します。
      *
      * 注意：ライブモードはLive Sync APIを使用して辞書を取得します。API呼び出しが
@@ -288,6 +444,19 @@ export default config;
 
 アプリケーションをラップするために Live Sync サーバーを起動します：
 
+スタンドアロンサーバーを使用した例：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... その他のスクリプト
+    "live:start": "npx intlayer live",
+  },
+}
+```
+
+`--process` 引数を使用して、アプリケーションサーバーと並行して使用することもできます。
+
 Next.js を使用した例：
 
 ```json5 fileName="package.json"
@@ -320,11 +489,11 @@ CMSからの変更通知を受け取るために、Live Syncサーバーはバ
 
 フローチャート（CMS/バックエンド -> Live Syncサーバー -> アプリケーションサーバー -> フロントエンド）:
 
-![Live Sync ロジックスキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+![Live Sync フロー CMS/バックエンド/Live Syncサーバー/アプリケーションサーバー/フロントエンド スキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
 
 動作の仕組み:
 
-![Live Sync フロー CMS/バックエンド/Live Syncサーバー/アプリケーションサーバー/フロントエンド スキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+![Live Sync ロジックスキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
 
 ### 開発ワークフロー（ローカル）
 
@@ -356,7 +525,7 @@ const config: IntlayerConfig = {
     importMode: "fetch",
   },
   build: {
-    optimize: true,
+    optimize: true, // default: process.env.NODE_ENV === 'production'
   },
 };
 
@@ -373,6 +542,18 @@ export default config;
 - `live`フラグはビルド時に各辞書ごとに評価されます。ビルド時にリモートコンテンツが`live=true`に設定されていなかった場合、その辞書のライブ同期を有効にするには再ビルドが必要です。
 - ライブ同期サーバーは`.intlayer`に書き込み可能でなければなりません。コンテナ環境では`/.intlayer`への書き込み権限を確保してください。
 
+## セルフホスティング
+
+Intlayer は、独自のインフラストラクチャ上で完全に実行できます。Docker Compose を使用して、フルスタック（ダッシュボード、API、データベース、オブジェクトストレージ、メール）を1行でブートストラップできます。
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+完全なセットアップガイド、環境変数リファレンス、アップグレード手順、バックアップ/復元手順については、[セルフホスティングガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)を参照してください。
+
+---
+
 ## デバッグ
 
 CMSで問題が発生した場合は、以下を確認してください：
@@ -381,9 +562,9 @@ CMSで問題が発生した場合は、以下を確認してください：
 
 - [`editor`](https://intlayer.org/doc/concept/configuration#editor-configuration)の設定がIntlayerの設定ファイルで正しく行われていること。
   - 必須フィールド：
-- アプリケーションのURLは、エディター設定の `applicationURL` と一致している必要があります。
-- CMSのURL
+    - アプリケーションのURLは、エディター設定の `applicationURL` と一致している必要があります。
+    - CMSのURL
 
 - プロジェクトの設定がIntlayer CMSにプッシュされていることを確認してください。
 
-- ビジュアルエディターはiframeを使用してウェブサイトを表示します。ウェブサイトのコンテンツセキュリティポリシー（CSP）がCMSのURLを `frame-ancestors`（デフォルトは 'https://intlayer.org'）として許可していることを確認してください。エディターのコンソールでエラーがないか確認してください。
+- ビジュアルエディターはiframeを使用してウェブサイトを表示します。ウェブサイトのコンテンツセキュリティポリシー（CSP）がCMSのURLを `frame-ancestors`（デフォルトは 'https://app.intlayer.org'）として許可していることを確認してください。エディターのコンソールでエラーがないか確認してください。

package/docs/ja/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-06-29
 title: Intlayer v9の新機能
 description: Intlayer v9の新機能をご覧ください。主要なi18nライブラリ向けのドロップイン互換性パッケージと、コレクション、バリアントのサポートを導入します。
 keywords:
@@ -9,6 +9,7 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
   - i18next
   - next-intl
   - vue-i18n
@@ -299,6 +300,34 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: Intlayer をヘッドレスコンテンツデータベースとして使う
+
+Intlayer v9 は、CMS をプログラムから操作するためのクリーンで自動認証される SDK を `@intlayer/api` に同梱しています。プロジェクトの取得、辞書の取得、そして自分のサーバー・スクリプト・CI からのプッシュや更新が可能です。認証（OAuth2 `client_credentials`）は自動的に処理・更新されます。
+
+SDK は **2 つの独立したインポート** に分かれており、実際に使用するドメインだけがバンドルに含まれます。
+
+1. `createIntlayerCMS` — 資格情報と管理されるトークンを保持する軽量な **認証器**（ドメインクライアントは同梱されません）。
+2. `dictionaryEndpoint`、`projectEndpoint`、… — ドメインごとの **エンドポイントバインダー**。それぞれ独自のサブパスからインポートします。
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// 設定は任意です。資格情報は INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET（`@intlayer/config/built` により解決）にフォールバックします。
+const cms = createIntlayerCMS();
+
+// 読み取り
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// 書き込み — CMS をデータベースのように使う
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> セキュリティ: CMS の資格情報はコンテンツへの書き込みアクセスを許可します。認証器は必ず **サーバーサイド** でのみ作成し、`clientId` / `clientSecret` をブラウザーに送らないでください。
+
+---
+
 ## v8からの移行に関する注意点
 
 v8からアップグレードする場合、v9には破壊的変更は含まれていません。ただし、主な変更点は次のとおりです。
@@ -314,3 +343,4 @@ v8からアップグレードする場合、v9には破壊的変更は含まれ
 - [互換アダプターパッケージガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)
 - [動的辞書 - コレクション、バリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)
 - [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
+- [CMS SDK - @intlayer/api によるプログラムからのアクセス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)