@intlayer/docs 9.0.0-canary.9 → 9.0.1

package/docs/tr/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Intlayer'ı Kendi Sunucunuzda Barındırma
+description: Tek bir komutla kendi altyapınızda eksiksiz bir Intlayer örneğini çalıştırın. Intlayer Cloud hesabı gerekmez.
+keywords:
+  - Kendi Sunucusunda Barındırma
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Kurulum
+  - Altyapı
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Intlayer'ı Kendi Sunucunuzda Barındırma
+
+Intlayer, tamamen kendi altyapınızda çalışabilir; Intlayer Cloud hesabı gerekmez. Tek bir komutla üretime hazır bir yığını başlatabilirsiniz:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Yükleyici, bir `docker-compose.yml` ve bir `.env` indirir, gerekli gizli anahtarları otomatik olarak oluşturur ve tüm kapsayıcıları `docker compose up -d` ile başlatır.
+
+## İçindekiler
+
+<TOC/>
+
+---
+
+## Mimari
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-düğüm RS)            (S3 API)     (SMTP)        (görüntü içinde)
+                             minio:9001   mailpit:8025
+                             (konsol)     (web arayüzü)
+```
+
+Chromium (Puppeteer ekran görüntüsü oluşturma için kullanılır) backend görüntüsünün içine dahil edilmiştir; ayrı bir kapsayıcıya gerek yoktur.
+
+---
+
+## Önkoşullar
+
+- **Docker** ≥ 24 ve **Docker Compose** ≥ v2. Herhangi biri eksikse, yükleyici kurulum bağlantısını yazdırır ve çıkar.
+- Ana bilgisayarda `3000`, `3100`, `8025`, `9000` ve `9001` bağlantı noktalarının kullanılabilir olması.
+- Bir Linux veya macOS ana bilgisayarı (veya Windows'ta WSL2).
+
+---
+
+## Hızlı Başlangıç
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Yükleyicinin yaptığı işlemler:
+
+1. `docker` ve `docker compose`'un mevcut olduğunu kontrol eder.
+2. `docker-compose.yml` ve `.env.example` dosyalarını `./intlayer/` dizinine indirir.
+3. `.env` dosyası mevcut değilse, örneği kopyalar ve `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` ve `S3_SECRET_ACCESS_KEY` için `openssl rand` aracılığıyla rastgele gizli anahtarlar oluşturur.
+4. `docker compose pull` + `docker compose up -d` komutlarını çalıştırır.
+5. URL'leri yazdırır: kontrol paneli `:3000`, API `:3100`, e-posta arayüzü `:8025`, MinIO konsolu `:9001`.
+
+Yığın çalışmaya başladıktan sonra **http://localhost:3000** adresini açın ve ilk hesabınızı oluşturun.
+
+---
+
+## Servisler
+
+| Servis      | Görüntü                                           | Ana Bilgisayar Bağlantı Noktası(ları) | Amaç                                                         |
+| ----------- | ------------------------------------------------- | ------------------------------------- | ------------------------------------------------------------ |
+| **app**     | `apps/app/Dockerfile` dosyasından oluşturuldu     | `3000`                                | TanStack Start kontrol paneli (CMS UI)                       |
+| **backend** | `apps/backend/Dockerfile` dosyasından oluşturuldu | `3100`                                | Fastify REST API (`/health` uç noktası)                      |
+| **mongo**   | `mongo:7`                                         | dahili                                | Tek düğümlü replika seti (`rs0`)                             |
+| **redis**   | `redis:7-alpine`                                  | dahili                                | İş kuyrukları (BullMQ) ve önbellekleme (ioredis)             |
+| **minio**   | `minio/minio`                                     | `9000` (S3), `9001` (konsol)          | Avatarlar ve ekran görüntüleri için S3 uyumlu nesne depolama |
+| **mailpit** | `axllent/mailpit`                                 | `1025` (SMTP), `8025` (web UI)        | Yerel işlem e-postası alıcısı                                |
+
+Dahili bağlantı noktaları (mongo, redis) varsayılan olarak ana bilgisayara açık değildir.
+
+> MinIO bağlantı noktası `9000` tarayıcı tarafından erişilebilir olmalıdır çünkü yüklenen varlıklar (avatarlar, ekran görüntüleri) doğrudan `S3_PUBLIC_URL=http://localhost:9000/intlayer` adresinden yüklenir.
+
+---
+
+## Ortam Değişkenleri
+
+Yükleyici, kullanıma hazır bir `.env` dosyası oluşturur. Aşağıdaki tablo her değişkeni açıklar.
+
+### Gerekli (otomatik oluşturulur veya istenir)
+
+| Değişken               | Örnek                                           | Açıklama                                                   |
+| ---------------------- | ----------------------------------------------- | ---------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Çalışma zamanı ortamı                                      |
+| `PORT`                 | `3100`                                          | Backend dinleme portu                                      |
+| `BACKEND_URL`          | `http://localhost:3100`                         | Backend API'sinin genel URL'si                             |
+| `APP_URL`              | `http://localhost:3000`                         | Kontrol panelinin genel URL'si                             |
+| `DOMAIN`               | `localhost`                                     | Çerez alanı                                                |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | Tam MongoDB bağlantı URI'si                                |
+| `REDIS_URL`            | `redis://redis:6379`                            | Redis bağlantı URL'si                                      |
+| `BETTER_AUTH_SECRET`   | _(oluşturuldu)_                                 | Oturum imzalamak için 32 baytlık gizli anahtar             |
+| `MAIL_PROVIDER`        | `smtp`                                          | E-posta taşıma yöntemi: `smtp` veya `resend`               |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | SMTP ana bilgisayar adı (Mailpit kapsayıcı adı)            |
+| `MAIL_SMTP_PORT`       | `1025`                                          | SMTP portu                                                 |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Gönderen adresi                                            |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3 uyumlu uç nokta                                         |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | Tarayıcı varlık yüklemesi için genel URL                   |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Kova adı                                                   |
+| `S3_ACCESS_KEY_ID`     | _(oluşturuldu)_                                 | MinIO erişim anahtarı                                      |
+| `S3_SECRET_ACCESS_KEY` | _(oluşturuldu)_                                 | MinIO gizli anahtarı                                       |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | Oluşturma zamanında kontrol paneline gömülü backend URL'si |
+| `VITE_DOMAIN`          | `localhost`                                     | Oluşturma zamanında kontrol paneline gömülü alan adı       |
+
+### İsteğe Bağlı (yokluğunda özellikler sorunsuz şekilde bozulur)
+
+| Değişken                                                 | Özellik                                                                     |
+| -------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | AI destekli çeviri ve içerik denetimi                                       |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Faturalandırma ve abonelik yönetimi                                         |
+| `RESEND_API_KEY`                                         | Resend aracılığıyla işlemsel e-posta (ayarlanırsa Mailpit'i geçersiz kılar) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | GitHub OAuth girişi                                                         |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Google OAuth girişi                                                         |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | GitLab OAuth girişi                                                         |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Microsoft OAuth girişi                                                      |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth girişi                                                       |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth girişi                                                      |
+
+---
+
+## Intlayer projenizi bağlama
+
+Yığın çalışmaya başladıktan sonra, projenizi `intlayer.org` yerine kendi barındırılan backend ve kontrol paneline yönlendirin.
+
+### Proje yapılandırması
+
+```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,
+
+    /**
+     * Kendi sunucunuzda barındırılan CMS kontrol panelinin URL'si.
+     * Varsayılan: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // örn. http://localhost:3000
+
+    /**
+     * Kendi sunucunuzda barındırılan backend API'sinin URL'si.
+     * Varsayılan: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // örn. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Projenizin `.env` dosyasında ortam değişkenlerini ayarlayın:
+
+```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>
+```
+
+Kendi barındırılan kontrol panelinizde **Projeler → Erişim Anahtarları** altında `http://localhost:3000/projects` adresinde erişim kimlik bilgileri oluşturun.
+
+### `@intlayer/api` SDK
+
+`@intlayer/api` SDK'sını programlı olarak kullanırken, `backendURL`'i açıkça geçirin:
+
+```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();
+```
+
+---
+
+## Yükseltme
+
+Mevcut bir dağıtım üzerinde yükleyiciyi yeniden çalıştırmak, kademeli bir yükseltme gerçekleştirir:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Bu, en son görüntüleri çeker ve kapsayıcıları `docker compose pull && docker compose up -d` ile yeniden başlatır. Mevcut birimler (`mongo-data`, `redis-data`, `minio-data`) korunur; veri kaybı olmaz.
+
+Manuel olarak `./intlayer/` dizini içinden yükseltme yapmak için:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Yedekleme ve Geri Yükleme
+
+Tüm kalıcı veriler, üç adet adlandırılmış Docker biriminde bulunur.
+
+### Yedekleme
+
+```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
+```
+
+### Geri Yükleme
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# redis-data ve minio-data için tekrarlayın
+```
+
+---
+
+## Ters Proxy Kullanımı (Nginx / Caddy)
+
+Üretim dağıtımları için, uygulama ve backend kapsayıcılarının önüne doğrudan açmak yerine bir ters proxy yerleştirin.
+
+### Nginx örneği
+
+```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;
+    }
+}
+```
+
+Aşağıdaki `.env` değişkenlerini genel alan adlarınızla eşleşecek şekilde güncelleyin:
+
+```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_*` değişkenleri oluşturma zamanında kontrol paneli görüntüsüne gömülür. Görüntü oluşturulduktan sonra bunları değiştirirseniz, `app` görüntüsünü yeniden oluşturmanız (`docker compose build app`) veya çalışma zamanı yapılandırma enjeksiyonu kullanmanız gerekir.
+
+---
+
+## Sorun Giderme
+
+### İlk Başlangıçta Backend Sürekli Çöküyor
+
+Backend başlamadan önce MongoDB ve Redis'in sağlıklı olması gerekir. Compose dosyası `condition: service_healthy` ile `depends_on` kullanır. Tekrarlayan backend yeniden başlatmaları görüyorsanız, `mongo` ve `redis` sağlık kontrollerinin geçtiğinden emin olun:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Kontrol Paneli API'ye Ulaşamıyor
+
+`VITE_BACKEND_URL`'in backend'e **tarayıcıdan** (Docker ağı değil) erişilebilen URL ile eşleştiğini doğrulayın. Backend portunu değiştirdiyseniz veya bir ters proxy eklediyseniz, kontrol paneli görüntüsünü yeniden oluşturun:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### E-posta Gönderilmiyor
+
+Varsayılan olarak, tüm giden e-postalar Mailpit tarafından yakalanır. Gönderilen mesajları görmek için `http://localhost:8025` adresini açın. Gerçek e-posta göndermek için `.env` dosyasında `MAIL_PROVIDER=resend` ve `RESEND_API_KEY=<anahtarınız>` ayarlayın, ardından backend'i yeniden başlatın:
+
+```sh
+docker compose restart backend
+```
+
+### MinIO Kovası Eksik
+
+Eğer `minio-init` tek seferlik servisi çalışmadıysa (veya MinIO hazır olmadan önce çalıştıysa), kovayı manuel olarak oluşturun:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Faydalı Bağlantılar
+
+- [Intlayer CMS belgeleri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
+- [Yapılandırma referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/uk/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js потребує плагіна `@intlayer/swc` для етапу опт
 
 > Цей плагін не встановлюється автоматично, адже плагіни SWC для Next.js ще мають експериментальний статус. У майбутньому це може змінитися.
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 Після встановлення Intlayer автоматично виявить і почне використовувати цей плагін.
 
 Для етапів **purge та minify** (видалення та перейменування полів) вам треба встановити поруч `@intlayer/babel` і додати Babel-плагіни. Оскільки Next.js хоча й застосовує SWC для трансформацій, але продовжує зчитувати `babel.config.js` під час збирання налаштувань плагінів, Babel-плагіни запускатимуться як пре-пас (попередня обробка) перед SWC.

package/docs/uk/cli/index.md

@@ -125,7 +125,7 @@ Intlayer приймає кілька форматів файлів конфіг
 
 ### Автентифікація
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/login.md)** - Автентифікація в Intlayer CMS та отримання облікових даних доступу
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/login.md)** - Автентифікація в Intlayer CMS та отримання облікових даних доступу
 
 ### Основні команди
 

package/docs/uk/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-Для більш низькорівневого доступу функція `scanWebsite` з модуля `@intlayer/chokidar/scan` повертає структурований об'єкт `ScanResult`:
+Для більш низькорівневого доступу функція `scanWebsite` з модуля `@intlayer/engine/scan` повертає структурований об'єкт `ScanResult`:
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);

package/docs/uk/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: Конфігурація
 description: Дізнайтеся, як налаштувати Intlayer для вашого додатка. Зрозумійте різні налаштування та параметри, доступні для адаптації Intlayer під ваші потреби.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Додано конфігурацію `analytics`"
   - version: 9.0.0
     date: 2026-06-24
     changes: "Add `enableProxy` option to the routing configuration"
@@ -355,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Конфігурація аналітики (analytics).
+   */
+  analytics: {
+    /**
+     * Чи увімкнено збір аналітики (перегляди сторінок, показ контенту, події A/B).
+     * Потребує встановленого `editor.clientId` для атрибуції.
+     * За замовчуванням: false
+     */
+    enabled: true,
+
+    /**
+     * Мілісекунди між автоматичними пакетними відправками на бекенд.
+     * За замовчуванням: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Частка сеансів для запису, від 0 (жодного) до 1 (усі).
+     * За замовчуванням: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Налаштування для перекладів та генерації за допомогою AI.
    */
@@ -668,6 +695,20 @@ export default config;
 
 ---
 
+### Конфігурація аналітики (Analytics)
+
+Визначає налаштування, пов'язані з аналітикою Intlayer: збір даних про те, який контент дійсно показується користувачам (перегляди сторінок, показ контенту), та підтримку A/B-тестування контенту.
+
+Аналітика є суворо опціональною (opt-in): нічого не збирається, якщо `analytics.enabled` явно не встановлено в `true` **та** не налаштовано ключ проєкту (`editor.clientId`) для атрибуції. Коли вимкнено (за замовчуванням), вся інтеграція аналітики видаляється зі збірки вашого застосунку (dead-code elimination).
+
+| Поле            | Опис                                                                   | Тип       | За замовчуванням | Приклад | Примітка                                                                                                                               |
+| --------------- | ---------------------------------------------------------------------- | --------- | ---------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Вмикає збір аналітики (перегляди сторінок, показ контенту, події A/B). | `boolean` | `false`          | `true`  | Потребує встановленого `editor.clientId` для атрибуції; інакше аналітика залишається вимкненою, навіть якщо `enabled` дорівнює `true`. |
+| `flushInterval` | Мілісекунди між автоматичними пакетними відправками на бекенд.         | `number`  | `20000`          | `10000` |                                                                                                                                        |
+| `sampleRate`    | Частка сеансів для запису, від `0` (жодного) до `1` (усі).             | `number`  | `1`              | `0.5`   | Вибірка є детермінованою для кожного сеансу, тому записаний сеанс повідомляє про всі свої події (без часткових воронок).               |
+
+---
+
 ### Конфігурація маршрутизації (Routing)
 
 Налаштування для контролю поведінки маршрутизації, включаючи структуру URL, зберігання локалі та керування проміжним ПЗ.

package/docs/uk/how_works_intlayer.md

@@ -220,9 +220,9 @@ The `@intlayer/webpack` package is used to provide a Webpack configuration to ma
 
 Пакети `@intlayer/dictionaries-entry`, `@intlayer/unmerged-dictionaries-entry` та `@intlayer/dynamic-dictionaries-entry` повертають шлях entry словників Intlayer. Оскільки з браузера неможливо виконувати пошук по файловій системі, використання bundler-ів, таких як Webpack або Rollup, для отримання шляху entry словників неможливе. Ці пакети розроблені для того, щоб їх можна було alias-ити, що дозволяє оптимізувати bundling для різних збирачів, таких як Vite, Webpack та Turbopack.
 
-### @intlayer/chokidar
+### @intlayer/engine
 
-Пакет `@intlayer/chokidar` використовується для моніторингу файлів контенту та перегенерації зміненого словника при кожній модифікації.
+Пакет `@intlayer/engine` використовується для моніторингу файлів контенту та перегенерації зміненого словника при кожній модифікації.
 
 ### @intlayer/editor
 

package/docs/uk/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-07-08
 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-07-08
+    changes: "Розділ «Live Sync» перенесено на окрему сторінку (live-sync.md), тут залишено короткий вступ і посилання"
+  - version: 9.0.0
+    date: 2026-06-30
+    changes: "Додано розділ «Самостійне розгортання»"
   - version: 6.0.1
     date: 2025-09-22
     changes: "Додано документацію `liveSync`"
@@ -245,144 +251,19 @@ bun x intlayer dictionary push -d my-first-dictionary-key --env production
 
 Live Sync дозволяє вашому застосунку відображати зміни контенту з CMS під час виконання. Немає потреби у перебудові або повторному розгортанні. Коли увімкнено, оновлення передаються на сервер Live Sync, який оновлює словники, які читає ваш застосунок.
 
-Увімкніть Live Sync, оновивши конфігурацію Intlayer:
+Повний посібник з налаштування (увімкнення, запуск сервера Live Sync, локальний робочий процес розробки та обмеження) наведено в [документації Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/live-sync.md).
 
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
+## Самостійне розгортання (Self-Hosting)
 
-const config: IntlayerConfig = {
-  // ... other configuration settings
-  editor: {
-    /**
-     * Увімкнення гарячого перезавантаження конфігурацій локалей при виявленні змін.
-     * Наприклад, коли словник додається або оновлюється, застосунок оновлює
-     * вміст, що відображається на сторінці.
-     *
-     * Оскільки гаряче перезавантаження вимагає постійного з'єднання з сервером,
-     * воно доступне лише клієнтам плану `enterprise`.
-     *
-     * За замовчуванням: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Керує способом імпорту словників:
-     *
-     * - "live": словники завантажуються динамічно за допомогою Live Sync API.
-     *   Замінює useIntlayer на useDictionaryDynamic.
-     *
-     * Примітка: режим live використовує Live Sync API для отримання словників. Якщо виклик API
-     * не вдасться, словники імпортуються динамічно.
-     * Примітка: режим live використовується лише для словників з віддаленим контентом і прапорцем "live".
-     * Інші використовують динамічний режим для кращої продуктивності.
-     */
-    importMode: "fetch",
-  },
-};
+Intlayer може працювати повністю на вашій власній інфраструктурі. Одна команда розгортає повний стек (дашборд, API, база даних, сховище об'єктів та електронна пошта) за допомогою Docker Compose:
 
-export default config;
-```
-
-Запустіть Live Sync сервер, щоб обгорнути ваш додаток:
-
-Приклад із окремим (standalone) сервером:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... інші скрипти
-    "live:start": "npx intlayer live",
-  },
-}
-```
-
-Ви також можете запустити сервер вашого додатку паралельно, використовуючи аргумент `--process`.
-
-Приклад із Next.js:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... інші скрипти
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-Приклад із Vite:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... інші скрипти
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
-  },
-}
-```
+Повний посібник із налаштування, довідник зі змінних середовища, інструкції з оновлення та процедури резервного копіювання/відновлення наведені в [Посібнику із самостійного розгортання](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md).
 
-Live Sync-сервер обгортає ваш додаток і автоматично застосовує оновлений контент у міру його надходження.
-
-Щоб отримувати сповіщення про зміни з CMS, Live Sync-сервер підтримує SSE-з'єднання з бекендом. Коли вміст у CMS змінюється, бекенд пересилає оновлення до Live Sync-сервера, який записує нові словники. Ваш додаток відобразить оновлення при наступній навігації або перезавантаженні браузера, без необхідності перебудови.
-
-Схема потоку (CMS/Backend -> Live Sync Server -> Application Server -> Frontend):
-
-![Схема потоку Live Sync (CMS/Backend -> Live Sync Server -> Application Server -> Frontend)](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)
-
-### Робочий процес розробки (локально)
-
-- Під час розробки всі віддалені словники завантажуються при запуску застосунку, тож ви можете швидко тестувати оновлення.
-- Щоб протестувати Live Sync локально з Next.js, обгорніть ваш dev-сервер:
-
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... інші скрипти
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Для Vite
-  },
-}
-```
-
-Увімкніть оптимізацію, щоб Intlayer застосовував трансформації Live import під час розробки:
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  editor: {
-    applicationURL: "http://localhost:5173",
-    liveSyncURL: "http://localhost:4000",
-    liveSync: true,
-  },
-  dictionary: {
-    importMode: "fetch",
-  },
-  build: {
-    optimize: true,
-  },
-};
-
-export default config;
-```
-
-Ця конфігурація обгортає ваш dev-сервер Live Sync-сервером, завантажує віддалені словники при старті та передає оновлення з CMS через SSE. Оновіть сторінку, щоб побачити зміни.
-
-Примітки та обмеження:
-
-- Додайте origin Live Sync до політики безпеки вашого сайту (CSP). Переконайтеся, що URL Live Sync дозволений у `connect-src` (і в `frame-ancestors`, якщо це доречно).
-- Live Sync не працює зі статичним виводом. Для Next.js сторінка має бути динамічною, щоб отримувати оновлення під час виконання (наприклад, використовуйте `generateStaticParams`, `generateMetadata`, `getServerSideProps` або `getStaticProps` відповідно, щоб уникнути повного обмеження лише статикою).
-- У CMS кожний словник має прапорець `live`. Лише словники з `live=true` завантажуються через API live sync; інші імпортуються динамічно і залишаються незмінними під час виконання.
-- Прапорець `live` оцінюється для кожного словника під час збірки. Якщо віддалений контент не мав `live=true` під час збірки, потрібно перебудувати проект, щоб увімкнути Live Sync для цього словника.
-- Сервер live sync має мати можливість записувати в `.intlayer`. У контейнерах переконайтеся, що є права запису до `/.intlayer`.
+---
 
 ## Налагодження