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

package/docs/ru/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-06-30
 title: Новый Intlayer v9 — Что нового?
 description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections и Variants.
 keywords:
@@ -9,6 +9,9 @@ keywords:
   - Миграция
   - Collections
   - Variants
+  - Self-Hosting
+  - Docker
+  - CMS SDK
   - i18next
   - next-intl
   - vue-i18n
@@ -299,6 +302,59 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: используйте Intlayer как headless-базу данных контента
+
+Intlayer v9 включает аккуратный SDK с автоматической аутентификацией в `@intlayer/api` для программного взаимодействия с CMS — получать проекты, получать словари, а также отправлять или обновлять их с вашего сервера, скриптов или CI. Аутентификация (OAuth2 `client_credentials`) выполняется и обновляется за вас.
+
+SDK разделён на **два отдельных импорта**, чтобы ваш бандл включал только те домены, которые вы действительно используете:
+
+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` в браузер.
+
+---
+
+## Самостоятельное размещение (Self-Hosting)
+
+Intlayer v9 поставляется с первоклассной поддержкой запуска собственного экземпляра Intlayer с помощью одной команды — учётная запись Intlayer Cloud не требуется.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Установщик загружает `docker-compose.yml` и `.env`, автоматически генерирует необходимые секреты и запускает `docker compose up -d`. Всё — дашборд, API, база данных, хранилище объектов и транзакционная электронная почта — работает локально в контейнерах.
+
+### Включённые сервисы
+
+| Сервис                                   | Назначение                                                                       |
+| ---------------------------------------- | -------------------------------------------------------------------------------- |
+| **app** (TanStack Start)                 | Дашборд UI на порту `3000`                                                       |
+| **backend** (Fastify/Bun)                | REST API на порту `3100`                                                         |
+| **MongoDB 7** (одноузловой набор реплик) | Основная база данных                                                             |
+| **Redis 7**                              | Очереди задач и кэширование                                                      |
+| **MinIO**                                | S3-совместимое хранилище объектов (аватары, скриншоты)                           |
+| **Mailpit**                              | Локальный SMTP-приёмник + веб-интерфейс для транзакционной почты на порту `8025` |
+
+Chromium (используемый для генерации скриншотов через Puppeteer) встроен в образ бэкенда — дополнительный контейнер не требуется.
+
+---
+
 ## Примечания по миграции с v8
 
 Если вы обновляетесь с v8, обратите внимание, что v9 не содержит ломающих изменений (breaking changes). Однако вот ключевые изменения:
@@ -314,3 +370,5 @@ npm install intlayer react-native-intlayer
 - [Руководство по пакетам адаптеров совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md)
 - [Динамические словари — Collections и Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)
 - [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)
+- [CMS SDK — программный доступ через @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)
+- [Руководство по самостоятельному размещению](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md)

package/docs/ru/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Самостоятельный хостинг Intlayer
+description: Запустите полноценный экземпляр Intlayer на собственной инфраструктуре с помощью одной команды. Аккаунт Intlayer Cloud не требуется.
+keywords:
+  - Самостоятельный хостинг
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Установка
+  - Инфраструктура
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Самостоятельный хостинг Intlayer
+
+Intlayer может полностью работать на вашей собственной инфраструктуре — аккаунт Intlayer Cloud не требуется. Одна команда запускает готовый к production стек:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Установщик загружает `docker-compose.yml` и `.env`, автоматически генерирует необходимые секреты и запускает все контейнеры с помощью `docker compose up -d`.
+
+## Оглавление
+
+<TOC/>
+
+---
+
+## Архитектура
+
+```
+                ┌─────────────────────────────┐
+ браузер ──────▶ │ приложение  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  бэкенд (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (RS из 1 узла)          (API S3)     (SMTP)        (в образе)
+                             minio:9001   mailpit:8025
+                             (консоль)    (веб-интерфейс)
+```
+
+Chromium (используемый для генерации скриншотов Puppeteer) включен в образ бэкенда — отдельный контейнер не требуется.
+
+---
+
+## Предварительные требования
+
+- **Docker** ≥ 24 и **Docker Compose** ≥ v2. Если что-либо из этого отсутствует, установщик выведет ссылку для установки и завершит работу.
+- Порты `3000`, `3100`, `8025`, `9000` и `9001` должны быть доступны на хосте.
+- Хост на Linux или macOS (или WSL2 на Windows).
+
+---
+
+## Быстрый старт
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Что делает установщик:
+
+1.  Проверяет наличие `docker` и `docker compose`.
+2.  Загружает `docker-compose.yml` и `.env.example` в `./intlayer/`.
+3.  Если файл `.env` отсутствует, копирует пример и генерирует случайные секреты для `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` и `S3_SECRET_ACCESS_KEY` с помощью `openssl rand`.
+4.  Запускает `docker compose pull` + `docker compose up -d`.
+5.  Выводит URL: панель управления `:3000`, API `:3100`, интерфейс электронной почты `:8025`, консоль MinIO `:9001`.
+
+После запуска стека откройте **http://localhost:3000** и создайте свою первую учетную запись.
+
+---
+
+## Сервисы
+
+| Сервис      | Образ                                 | Порт(ы) хоста                         | Назначение                                                        |
+| ----------- | ------------------------------------- | ------------------------------------- | ----------------------------------------------------------------- |
+| **app**     | построен из `apps/app/Dockerfile`     | `3000`                                | Панель управления TanStack Start (пользовательский интерфейс CMS) |
+| **backend** | построен из `apps/backend/Dockerfile` | `3100`                                | REST API Fastify (эндпоинт `/health`)                             |
+| **mongo**   | `mongo:7`                             | внутренний                            | Репликационный набор из одного узла (`rs0`)                       |
+| **redis**   | `redis:7-alpine`                      | внутренний                            | Очереди заданий (BullMQ) и кеширование (ioredis)                  |
+| **minio**   | `minio/minio`                         | `9000` (S3), `9001` (консоль)         | S3-совместимое объектное хранилище для аватаров и скриншотов      |
+| **mailpit** | `axllent/mailpit`                     | `1025` (SMTP), `8025` (веб-интерфейс) | Локальный приемник транзакционных электронных писем               |
+
+Внутренние порты (mongo, redis) по умолчанию не открыты на хосте.
+
+> Порт MinIO `9000` должен быть доступен из браузера, поскольку загруженные активы (аватары, скриншоты) загружаются непосредственно из `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Переменные окружения
+
+Установщик генерирует готовый к использованию файл `.env`. В таблице ниже описана каждая переменная.
+
+### Обязательные (автоматически генерируемые или запрашиваемые)
+
+| Переменная             | Пример                                          | Описание                                                    |
+| ---------------------- | ----------------------------------------------- | ----------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Среда выполнения                                            |
+| `PORT`                 | `3100`                                          | Порт прослушивания бэкенда                                  |
+| `BACKEND_URL`          | `http://localhost:3100`                         | Публичный URL API бэкенда                                   |
+| `APP_URL`              | `http://localhost:3000`                         | Публичный URL панели управления                             |
+| `DOMAIN`               | `localhost`                                     | Домен для файлов cookie                                     |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | Полный URI для подключения к MongoDB                        |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL для подключения к Redis                                 |
+| `BETTER_AUTH_SECRET`   | _(сгенерирован)_                                | 32-байтный секрет для подписи сессий                        |
+| `MAIL_PROVIDER`        | `smtp`                                          | Транспорт для почты: `smtp` или `resend`                    |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Имя хоста SMTP (имя контейнера Mailpit)                     |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Порт SMTP                                                   |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Адрес отправителя                                           |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3-совместимый эндпоинт                                     |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | Публичный URL для загрузки активов браузером                |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Имя корзины                                                 |
+| `S3_ACCESS_KEY_ID`     | _(сгенерирован)_                                | Ключ доступа MinIO                                          |
+| `S3_SECRET_ACCESS_KEY` | _(сгенерирован)_                                | Секретный ключ MinIO                                        |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL бэкенда, встроенный в панель управления во время сборки |
+| `VITE_DOMAIN`          | `localhost`                                     | Домен, встроенный в панель управления во время сборки       |
+
+### Необязательные (функции работают с ограничениями, если отсутствуют)
+
+| Переменная                                               | Функция                                                                                   |
+| -------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Перевод и аудит контента с помощью ИИ                                                     |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Управление счетами и подписками                                                           |
+| `RESEND_API_KEY`                                         | Транзакционные электронные письма через Resend (переопределяет Mailpit, если установлено) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Вход через GitHub OAuth                                                                   |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Вход через Google OAuth                                                                   |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Вход через GitLab OAuth                                                                   |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Вход через Microsoft OAuth                                                                |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Вход через LinkedIn OAuth                                                                 |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Вход через Atlassian OAuth                                                                |
+
+---
+
+## Подключение вашего проекта Intlayer
+
+После запуска стека направьте свой проект на самохостинговый бэкенд и панель управления вместо `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 самохостинговой панели управления CMS.
+     * По умолчанию: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL самохостингового API бэкенда.
+     * По умолчанию: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Установите переменные окружения в файле `.env` вашего проекта:
+
+```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>
+```
+
+Создайте учетные данные доступа на вашей самохостинговой панели управления в разделе **Проекты → Ключи доступа** по адресу `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+При программном использовании SDK `@intlayer/api` явно передайте `backendURL`:
+
+```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();
+```
+
+---
+
+## Обновление
+
+Повторный запуск установщика на существующем развертывании выполняет скользящее обновление:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Это загружает последние образы и перезапускает контейнеры с помощью `docker compose pull && docker compose up -d`. Существующие тома (`mongo-data`, `redis-data`, `minio-data`) сохраняются — потери данных нет.
+
+Для обновления вручную из директории `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Резервное копирование и восстановление
+
+Все постоянные данные хранятся в трех именованных томах Docker.
+
+### Резервное копирование
+
+```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
+```
+
+### Восстановление
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Повторите для redis-data и minio-data
+```
+
+---
+
+## Использование обратного прокси (Nginx / Caddy)
+
+Для production развертываний разместите обратный прокси перед контейнерами приложения и бэкенда вместо того, чтобы открывать их напрямую.
+
+### Пример 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;
+    }
+}
+```
+
+Обновите следующие переменные `.env`, чтобы они соответствовали вашим публичным доменам:
+
+```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
+```
+
+> Переменные `VITE_*` встраиваются в образ панели управления во время сборки. Если вы измените их после сборки образа, вам потребуется пересобрать образ `app` (`docker compose build app`) или использовать инъекцию runtime-конфигурации.
+
+---
+
+## Устранение неполадок
+
+### Бэкенд циклически перезапускается при первом запуске
+
+MongoDB и Redis должны быть работоспособны до запуска бэкенда. Файл compose использует `depends_on` с `condition: service_healthy`. Если вы видите повторяющиеся перезапуски бэкенда, убедитесь, что проверки работоспособности `mongo` и `redis` проходят:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Панель управления не может связаться с API
+
+Убедитесь, что `VITE_BACKEND_URL` соответствует URL, по которому бэкенд доступен из **браузера** (а не из сети Docker). Если вы изменили порт бэкенда или добавили обратный прокси, пересоберите образ панели управления:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Электронные письма не отправляются
+
+По умолчанию вся исходящая почта перехватывается Mailpit. Откройте `http://localhost:8025`, чтобы увидеть отправленные сообщения. Для отправки реальных писем установите `MAIL_PROVIDER=resend` и `RESEND_API_KEY=<your-key>` в `.env`, затем перезапустите бэкенд:
+
+```sh
+docker compose restart backend
+```
+
+### Отсутствует корзина MinIO
+
+Если одноразовый сервис `minio-init` не запустился (или запустился до того, как MinIO был готов), создайте корзину вручную:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Полезные ссылки
+
+- [Документация Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)
+- [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)

package/docs/tr/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-06-30
 title: Intlayer CMS | İçeriğinizi Intlayer CMS'ye Dışa Aktarın
 description: İçeriğinizin yönetimini ekibinize devretmek için içeriğinizi Intlayer CMS'ye dışa aktarın.
 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: "Kendi Sunucuda Barındırma bölümü eklendi"
   - version: 6.0.1
     date: 2025-09-22
     changes: "Canlı senkronizasyon dokümantasyonu eklendi"
@@ -372,6 +375,18 @@ Notlar ve kısıtlamalar:
 - `live` bayrağı her sözlük için build zamanında değerlendirilir. Uzaktaki içerik derleme sırasında `live=true` olarak işaretlenmemişse, o sözlük için Live Sync'i etkinleştirmek üzere yeniden derleme yapmanız gerekir.
 - Live sync sunucusunun `.intlayer` dosyasına yazabilmesi gerekir. Konteynerlerde, `/.intlayer` dosyasına yazma erişiminin olduğundan emin olun.
 
+## Kendi Sunucunuzda Barındırma
+
+Intlayer, tamamen kendi altyapınızda çalışabilir. Tek bir komut, tam yığını (kontrol paneli, API, veritabanı, nesne depolama ve e-posta) Docker Compose ile başlatır:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Tam kurulum kılavuzu, ortam değişkeni referansı, yükseltme talimatları ve yedekleme/geri yükleme prosedürleri için [Kendi Sunucuda Barındırma Kılavuzu'na](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/self_hosting.md) bakınız.
+
+---
+
 ## Hata Ayıklama
 
 CMS ile ilgili herhangi bir sorunla karşılaşırsanız, aşağıdakileri kontrol edin:

package/docs/tr/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-06-30
 title: Yeni Intlayer v9 - Yenilikler Neler?
 description: Intlayer v9'daki yenilikleri keşfedin. Popüler i18n kütüphaneleri için doğrudan uyumlu paketler ve Koleksiyonlar ve Varyantlar desteği sunuluyor.
 keywords:
@@ -9,6 +9,9 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
@@ -299,6 +302,46 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: Intlayer'ı başsız içerik veritabanı olarak kullanın
+
+Intlayer v9, CMS ile programatik olarak etkileşim kurmak için `@intlayer/api` içinde temiz ve kendi kendine kimlik doğrulayan bir SDK sunar — projeleri getirin, sözlükleri getirin ve bunları kendi sunucunuzdan, betiklerinizden veya CI'nizden gönderin ya da güncelleyin. Kimlik doğrulama (OAuth2 `client_credentials`) sizin için yönetilir ve yenilenir.
+
+SDK **iki ayrı içe aktarmaya** bölünmüştür; böylece paketiniz yalnızca gerçekten kullandığınız alanları içerir:
+
+1. `createIntlayerCMS` — kimlik bilgilerini ve yönetilen jetonu tutan hafif bir **kimlik doğrulayıcı** (hiçbir alan istemcisi pakete dahil edilmez).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — her biri kendi alt yolundan içe aktarılan, alan başına **endpoint bağlayıcıları**.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// Yapılandırma isteğe bağlıdır: kimlik bilgileri INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET değerlerine geri döner (`@intlayer/config/built` tarafından çözülür).
+const cms = createIntlayerCMS();
+
+// Okuma
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Yazma — CMS'i bir veritabanı gibi kullanın
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Güvenlik: CMS kimlik bilgileri içeriğinize yazma erişimi verir. Kimlik doğrulayıcıyı her zaman yalnızca **sunucu tarafında** oluşturun — `clientId` / `clientSecret` değerlerini asla tarayıcıya göndermeyin.
+
+---
+
+## Kendi Sunucunuzda Barındırma
+
+Intlayer v9, tek bir komutla kendi Intlayer örneğinizi çalıştırmak için birinci sınıf destek sunuyor — Intlayer Cloud hesabı gerekmez.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Yükleyici, bir `docker-compose.yml` ve bir `.env` dosyasını indirir, gerekli gizli anahtarları otomatik olarak oluşturur ve `docker compose up -d` komutunu çalıştırır. Kontrol paneli, API, veritabanı, nesne depolama ve işlemsel e-posta dahil her şey yerel olarak kapsayıcılarda çalışır.
+
+---
+
 ## v8'den Geçiş Notları
 
 v8'den yükseltme yapıyorsanız, v9'un yıkıcı değişiklikler (breaking changes) içermediğini unutmayın. Ancak işte temel değişiklikler:
@@ -314,3 +357,5 @@ v8'den yükseltme yapıyorsanız, v9'un yıkıcı değişiklikler (breaking chan
 - [Compat Adapter Paketleri Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compat/index.md)
 - [Dinamik Sözlükler - Koleksiyonlar ve Varyantlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md)
 - [Yapılandırma Referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
+- [CMS SDK - @intlayer/api ile programatik erişim](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
+- [Kendi Sunucuda Barındırma Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/self_hosting.md)