@intlayer/docs 9.0.0-canary.8 → 9.0.0

package/docs/de/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Neues Intlayer v9 – Was ist neu?
 description: Entdecken Sie die Neuerungen in Intlayer v9. Einführung von Drop-in-Kompatibilitätspaketen für beliebte i18n-Bibliotheken und Unterstützung für Collections und Variants.
 keywords:
@@ -9,9 +9,13 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=ia6JmVf-kkU
 slugs:
   - doc
   - releases
@@ -23,6 +27,14 @@ author: aymericzip
 
 Willkommen bei Intlayer v9! Dieses Major Release markiert einen riesigen Meilenstein bei der Vereinfachung des Migrationspfads zu Intlayer mit **Compat Adapter Packages** für wichtige i18n-Bibliotheken (`react-i18next`, `next-intl`, `vue-i18n`, etc.) und fügt Unterstützung für reichhaltige Inhaltsstrukturen hinzu: **Collections** und **Variants**.
 
+<iframe
+  src="https://www.youtube.com/embed/ia6JmVf-kkU"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## Inhaltsverzeichnis
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +121,40 @@ Intlayer v9 geht über statische Schlüssel-Wert-Objekte hinaus und ermöglicht
 
 Definieren Sie eine CMS-verwaltete Liste geordneter Elemente (z.B. FAQs, Produkte oder Bloglisten):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        de: "Was ist Intlayer?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        de: "Ein i18n-Toolkit.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Verwendung:
 
 ```ts
-// Alle Elemente abrufen
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Einzelnes Element nach Index abrufen
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Variants
@@ -192,28 +208,52 @@ export default {
 ```ts
 // Ruft nur das angeforderte Element dynamisch ab (erfordert Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Dynamisches Laden & Optimierungen der Bundle-Größe
-
-Um Bundles extrem klein zu halten, unterstützt Intlayer v9 dynamisches Lazy Loading.
-
-Stellen Sie in Ihrer Konfiguration `importMode` auf `'dynamic'` oder `'fetch'` ein:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: Content-Exposure-Tracking & A/B-Tests
+
+Ein neues optionales Paket, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), zeigt Ihnen, welche Inhalte Ihren Besuchern tatsächlich angezeigt werden — und schließt damit den Kreis zu **Collections & Variants**, indem es Ihnen ermöglicht, Inhalte per A/B-Test zu testen und Conversions pro Variante zu messen.
+
+- **Tracking auf Provider-Ebene**: `IntlayerProvider` (React / Next.js / React Native) erfasst automatisch `page_view`-Ereignisse beim Laden, bei Routenwechseln und bei Sprachwechseln.
+- **Tracking auf Knotenebene**: Jede Auflösung von `useIntlayer` meldet ein `content_exposure`-Ereignis — welcher Dictionary-Schlüssel, Key-Path, welche Sprache und (falls zutreffend) welche A/B-**Variante** angezeigt wurde. Wiederholte Anzeigen desselben Knotens innerhalb eines Flush-Fensters werden zu einem Ereignis zusammengefasst.
+- **Deterministische A/B-Zuweisung**: `getVariant(experimentKey, variants)` weist jeder Sitzung eine Variante zu — **ohne Server-Roundtrip**, sodass kein Flackern vor dem ersten Rendering auftritt.
+- **`useConversion()`**: ordnet ein Ziel (Registrierung, Klick, Kauf …) der Variante zu, der die Sitzung ausgesetzt war.
+- **Keine Kosten, wenn nicht installiert**: gleiches tree-shakeable Muster wie bei `@intlayer/editor` — dynamischer, in `try/catch` gekapselter `import()`, plus eine Build-Zeit-Umgebungsvariable (`INTLAYER_ANALYTICS_ENABLED`), die die gesamte Integration für Apps, die sie nicht nutzen, per Dead-Code-Elimination entfernt.
+- **Kein neues Konfigurationsschema**: verwendet weiterhin `editor.backendURL` (Ingestion-Endpunkt / Self-Hosting) und `editor.clientId` (Projektschlüssel, zugleich Aktivierungsschalter).
+- **Datenschutzfreundlich**: anonymes Session-Hashing (SHA-256, keine Rohkennungen gespeichert), keine IP-Speicherung, nur grobe länderbasierte Geolokalisierung, gebündelte Anfragen etwa alle 20 Sekunden.
+- **Dashboard**: Eine neue **Analytics**-Seite (in der Seitenleiste sichtbar, sobald ein Projekt ausgewählt ist) zeigt aktive Nutzer, Nutzer heute, Nutzer der letzten 7/30/90 Tage, einen Besucherentwicklungsgraphen sowie Aufschlüsselungen nach Sprache und Standort.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-Zur Build-Zeit scannen `@intlayer/swc` und `@intlayer/babel` Ihre Dateien und ersetzen `useIntlayer` / `getIntlayer`-Aufrufe durch tree-shakeable Wrapper (`useDictionary` / `useDictionaryDynamic`). Nur der für das ausgewählte Collection-Element, die Variante oder das Locale erforderliche Inhalt wird geladen, wodurch verhindert wird, dass Ihr Produktions-Bundle ungenutzte Übersetzungen enthält.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Bereits heute verfügbar für React, Next.js und React Native (über `react-intlayer`); weitere Framework-Anbindungen (Vue, Svelte, Angular, …) sind geplant und folgen demselben Rollout-Muster wie `@intlayer/editor`. Die vollständige Anleitung finden Sie in der [Analytics-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md).
 
 ---
 
@@ -296,13 +336,68 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: Intlayer als Headless-Content-Datenbank nutzen
+
+Intlayer v9 enthält ein sauberes, sich selbst authentifizierendes SDK in `@intlayer/api`, um programmgesteuert mit dem CMS zu interagieren – Projekte abrufen, Dictionaries abrufen sowie diese von Ihrem eigenen Server, Skripten oder CI aus pushen oder aktualisieren. Die Authentifizierung (OAuth2 `client_credentials`) wird für Sie übernommen und erneuert.
+
+Das SDK ist in **zwei getrennte Importe** aufgeteilt, sodass Ihr Bundle nur die Domänen enthält, die Sie tatsächlich verwenden:
+
+1. `createIntlayerCMS` – ein leichtgewichtiger **Authentifikator**, der die Anmeldedaten und das verwaltete Token hält (kein Domänen-Client gebündelt).
+2. `dictionaryEndpoint`, `projectEndpoint`, … – **Endpoint-Binder** pro Domäne, jeweils aus ihrem eigenen Unterpfad importiert.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// Konfiguration ist optional: Anmeldedaten fallen auf INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET zurück, aufgelöst durch `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Lesen
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Schreiben – nutze das CMS wie eine Datenbank
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Sicherheit: Die CMS-Anmeldedaten gewähren Schreibzugriff auf Ihre Inhalte. Erstellen Sie den Authentifikator immer nur **serverseitig** – senden Sie `clientId` / `clientSecret` niemals an den Browser.
+
+---
+
+## Self-Hosting
+
+Intlayer v9 bietet erstklassige Unterstützung für den Betrieb Ihrer eigenen Intlayer-Instanz mit einem einzigen Befehl – kein Intlayer Cloud-Konto erforderlich.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Das Installationsprogramm lädt eine `docker-compose.yml` und eine `.env` herunter, generiert automatisch die erforderlichen Secrets und führt `docker compose up -d` aus. Alles – das Dashboard, die API, die Datenbank, der Objektspeicher und die transaktionale E-Mail – läuft lokal in Containern.
+
+### Enthaltene Dienste
+
+| Dienst                                  | Zweck                                                                 |
+| --------------------------------------- | --------------------------------------------------------------------- |
+| **app** (TanStack Start)                | Dashboard-Oberfläche auf Port `3000`                                  |
+| **backend** (Fastify/Bun)               | REST API auf Port `3100`                                              |
+| **MongoDB 7** (single-node replica set) | Primäre Datenbank                                                     |
+| **Redis 7**                             | Job-Warteschlangen und Caching                                        |
+| **MinIO**                               | S3-kompatibler Objektspeicher (Avatare, Screenshots)                  |
+| **Mailpit**                             | Lokale SMTP-Senke + Web-UI für transaktionale E-Mails auf Port `8025` |
+
+Chromium (für die Puppeteer-Screenshot-Generierung verwendet) ist im Backend-Image gebündelt – kein zusätzlicher Container erforderlich.
+
+---
+
 ## Migrationshinweise von v8
 
 Wenn Sie von v8 upgraden, beachten Sie, dass v9 keine Breaking Changes enthält. Hier sind jedoch die wichtigsten Änderungen:
 
 - **Compiler standardmäßig deaktiviert**: `compiler.enabled` ist jetzt standardmäßig `false`. Wenn Sie auf die Extraktion Ihrer `.content.ts`-Dateien zur Build-Zeit angewiesen sind, setzen Sie `compiler.enabled: true` in Ihrer `intlayer.config.ts`.
+- **Vite-Plugin**: Der Compiler und der Locale-Routing-Proxy sind nun in `intlayer()` gebündelt. Falls Sie zuvor `intlayerCompiler()` oder `intlayerProxy()` manuell registriert haben, können Sie diese entfernen – sie werden automatisch dedupliziert, sodass das Beibehalten harmlos ist. Verwenden Sie `routing.enableProxy: false`, um den Proxy zu deaktivieren.
 - **Locales & Dialects**: Wenn Sie externe i18n-Abhängigkeiten verwenden, fügen Sie deren entsprechende Kompatibilitätsadapter-Plugins in Ihrer Konfiguration oder Ihrem Bundler-Setup hinzu, um Imports automatisch umzuschreiben.
 - **Custom Selectors**: Beim Aufruf von `useIntlayer` ist der zweite Parameter nun für ein Options-Objekt reserviert, das `{ locale, item, variant }` enthält. Wenn Sie zuvor direkt einen Locale-String übergeben haben, können Sie dies weiterhin tun, aber die Verwendung des Options-Objekts wird für erweiterte Auswahlen empfohlen.
+- **React Native**: `react-native-intlayer` re-exportiert nun die gesamte `react-intlayer` API. Importieren Sie in einer React Native App alles aus `react-native-intlayer` und entfernen Sie die direkte `react-intlayer`-Abhängigkeit. Bestehende `react-intlayer`-Imports funktionieren weiterhin.
 
 ---
 
@@ -310,4 +405,7 @@ Wenn Sie von v8 upgraden, beachten Sie, dass v9 keine Breaking Changes enthält.
 
 - [Leitfaden für Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/compat/index.md)
 - [Dynamische Dictionaries – Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/index.md)
+- [Analytics - Content-Exposure-Tracking & A/B-Tests](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Konfigurationsreferenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md)
+- [CMS SDK – Programmatischer Zugriff mit @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md)
+- [Self-Hosting-Leitfaden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/self_hosting.md)

package/docs/de/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: "Intlayer selbst hosten"
+description: "Betreiben Sie eine komplette Intlayer-Instanz auf Ihrer eigenen Infrastruktur mit einem einzigen Befehl. Kein Intlayer Cloud-Konto erforderlich."
+keywords:
+  - Selbst-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastruktur
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Intlayer selbst hosten
+
+Intlayer kann vollständig auf Ihrer eigenen Infrastruktur ausgeführt werden – kein Intlayer Cloud-Konto erforderlich. Ein einziger Befehl startet einen produktionsbereiten Stack:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Der Installer lädt eine `docker-compose.yml` und eine `.env` herunter, generiert automatisch die erforderlichen Secrets und startet alle Container mit `docker compose up -d`.
+
+## Inhaltsverzeichnis
+
+<TOC/>
+
+---
+
+## Architektur
+
+```
+                ┌─────────────────────────────┐
+ 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 (wird für die Erzeugung von Puppeteer-Screenshots verwendet) ist im Backend-Image gebündelt – es wird kein separater Container benötigt.
+
+---
+
+## Voraussetzungen
+
+- **Docker** ≥ 24 und **Docker Compose** ≥ v2. Fehlt eines davon, gibt der Installer den Installationslink aus und beendet sich.
+- Ports `3000`, `3100`, `8025`, `9000` und `9001` auf dem Host verfügbar.
+- Ein Linux- oder macOS-Host (oder WSL2 unter Windows).
+
+---
+
+## Schnellstart
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Was der Installer tut:
+
+1.  Überprüft, ob `docker` und `docker compose` vorhanden sind.
+2.  Lädt `docker-compose.yml` und `.env.example` in `./intlayer/` herunter.
+3.  Falls keine `.env` existiert, kopiert er das Beispiel und generiert zufällige Secrets für `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` und `S3_SECRET_ACCESS_KEY` mittels `openssl rand`.
+4.  Führt `docker compose pull` + `docker compose up -d` aus.
+5.  Gibt die URLs aus: Dashboard `:3000`, API `:3100`, E-Mail-UI `:8025`, MinIO-Konsole `:9001`.
+
+Nachdem der Stack gestartet ist, öffnen Sie **http://localhost:3000** und erstellen Sie Ihr erstes Konto.
+
+---
+
+## Dienste
+
+| Service     | Image                                | Host port(s)                                   | Zweck                                                     |
+| :---------- | :----------------------------------- | :--------------------------------------------- | :-------------------------------------------------------- |
+| **app**     | built from `apps/app/Dockerfile`     | `3000`                                         | TanStack Start Dashboard (CMS-Benutzeroberfläche)         |
+| **backend** | built from `apps/backend/Dockerfile` | `3100`                                         | Fastify REST API (`/health` Endpunkt)                     |
+| **mongo**   | `mongo:7`                            | intern                                         | Einzelknoten-Replica Set (`rs0`)                          |
+| **redis**   | `redis:7-alpine`                     | intern                                         | Job-Warteschlangen (BullMQ) und Caching (ioredis)         |
+| **minio**   | `minio/minio`                        | `9000` (S3), `9001` (Konsole)                  | S3-kompatibler Objektspeicher für Avatare und Screenshots |
+| **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (Web-Benutzeroberfläche) | Lokale Transaktions-E-Mail-Senke                          |
+
+Interne Ports (mongo, redis) werden standardmäßig nicht zum Host exponiert.
+
+> MinIO-Port `9000` muss vom Browser erreichbar sein, da hochgeladene Assets (Avatare, Screenshots) direkt von `S3_PUBLIC_URL=http://localhost:9000/intlayer` geladen werden.
+
+---
+
+## Umgebungsvariablen
+
+Der Installer generiert eine gebrauchsfertige `.env`. Die folgende Tabelle beschreibt jede Variable.
+
+### Erforderlich (automatisch generiert oder abgefragt)
+
+| Variable               | Beispiel                                        | Beschreibung                                                     |
+| :--------------------- | :---------------------------------------------- | :--------------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Laufzeitumgebung                                                 |
+| `PORT`                 | `3100`                                          | Backend-Listenport                                               |
+| `BACKEND_URL`          | `http://localhost:3100`                         | Öffentliche URL der Backend-API                                  |
+| `APP_URL`              | `http://localhost:3000`                         | Öffentliche URL des Dashboards                                   |
+| `DOMAIN`               | `localhost`                                     | Cookie-Domain                                                    |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | Vollständige MongoDB-Verbindungs-URI                             |
+| `REDIS_URL`            | `redis://redis:6379`                            | Redis-Verbindungs-URL                                            |
+| `BETTER_AUTH_SECRET`   | _(generiert)_                                   | 32-Byte-Secret für die Session-Signierung                        |
+| `MAIL_PROVIDER`        | `smtp`                                          | Mail-Transport: `smtp` oder `resend`                             |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | SMTP-Hostname (Mailpit Container-Name)                           |
+| `MAIL_SMTP_PORT`       | `1025`                                          | SMTP-Port                                                        |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Absenderadresse                                                  |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3-kompatibler Endpunkt                                          |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | Öffentliche URL für das Laden von Browser-Assets                 |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Bucket-Name                                                      |
+| `S3_ACCESS_KEY_ID`     | _(generiert)_                                   | MinIO-Zugangsschlüssel                                           |
+| `S3_SECRET_ACCESS_KEY` | _(generiert)_                                   | MinIO-Geheimschlüssel                                            |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | Backend-URL, die zur Build-Zeit in das Dashboard integriert wird |
+| `VITE_DOMAIN`          | `localhost`                                     | Domain, die zur Build-Zeit in das Dashboard integriert wird      |
+
+### Optional (Funktionen funktionieren bei Abwesenheit eingeschränkt)
+
+| Variable                                                 | Funktion                                                             |
+| :------------------------------------------------------- | :------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | KI-gestützte Übersetzung und Inhaltsprüfung                          |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Abrechnung und Abonnementverwaltung                                  |
+| `RESEND_API_KEY`                                         | Transaktions-E-Mail über Resend (überschreibt Mailpit, wenn gesetzt) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | GitHub OAuth-Login                                                   |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Google OAuth-Login                                                   |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | GitLab OAuth-Login                                                   |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Microsoft OAuth-Login                                                |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth-Login                                                 |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth-Login                                                |
+
+---
+
+## Ihr Intlayer-Projekt verbinden
+
+Sobald der Stack läuft, verweisen Sie Ihr Projekt auf das selbst gehostete Backend und Dashboard anstelle von `intlayer.org`.
+
+### Projektkonfiguration
+
+```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 des selbst gehosteten CMS-Dashboards.
+     * Standard: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL der selbst gehosteten Backend-API.
+     * Standard: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Setzen Sie die Umgebungsvariablen in der `.env` Ihres Projekts:
+
+```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>
+```
+
+Erstellen Sie Zugangsdaten in Ihrem selbst gehosteten Dashboard unter **Projects → Access keys** unter `http://localhost:3000/projects`.
+
+### `@intlayer/api` SDK
+
+Wenn Sie das `@intlayer/api` SDK programmatisch verwenden, übergeben Sie `backendURL` explizit:
+
+```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();
+```
+
+---
+
+## Upgrade
+
+Ein erneutes Ausführen des Installers auf einer bestehenden Bereitstellung führt ein Rolling-Upgrade durch:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Dies zieht die neuesten Images und startet Container neu mit `docker compose pull && docker compose up -d`. Bestehende Volumes (`mongo-data`, `redis-data`, `minio-data`) bleiben erhalten – kein Datenverlust.
+
+Um manuell aus dem `./intlayer/`-Verzeichnis ein Upgrade durchzuführen:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Backup und Wiederherstellung
+
+Alle persistenten Daten befinden sich in drei benannten Docker-Volumes.
+
+### 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
+```
+
+### Wiederherstellung
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Wiederholen Sie dies für redis-data und minio-data
+```
+
+---
+
+## Verwendung eines Reverse-Proxys (Nginx / Caddy)
+
+Für Produktionsbereitstellungen platzieren Sie einen Reverse-Proxy vor den App- und Backend-Containern, anstatt sie direkt zu exponieren.
+
+### Nginx-Beispiel
+
+```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;
+    }
+}
+```
+
+Aktualisieren Sie die folgenden `.env`-Variablen, um sie an Ihre öffentlichen Domains anzupassen:
+
+```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_*`-Variablen werden zur Build-Zeit in das Dashboard-Image integriert. Wenn Sie diese nach dem Bau des Images ändern, müssen Sie das `app`-Image neu erstellen (`docker compose build app`) oder die Laufzeitkonfigurationsinjektion verwenden.
+
+---
+
+## Fehlerbehebung
+
+### Backend-Absturzschleifen beim ersten Start
+
+MongoDB und Redis müssen fehlerfrei sein, bevor das Backend startet. Die Compose-Datei verwendet `depends_on` mit `condition: service_healthy`. Wenn Sie wiederholte Backend-Neustarts sehen, überprüfen Sie, ob die `mongo`- und `redis`-Healthchecks erfolgreich sind:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Dashboard kann die API nicht erreichen
+
+Stellen Sie sicher, dass `VITE_BACKEND_URL` der URL entspricht, unter der das Backend vom **Browser** (nicht vom Docker-Netzwerk) aus erreichbar ist. Wenn Sie den Backend-Port geändert oder einen Reverse-Proxy hinzugefügt haben, erstellen Sie das Dashboard-Image neu:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### E-Mail wird nicht gesendet
+
+Standardmäßig werden alle ausgehenden E-Mails von Mailpit abgefangen. Öffnen Sie `http://localhost:8025`, um gesendete Nachrichten anzuzeigen. Um echte E-Mails zu senden, setzen Sie `MAIL_PROVIDER=resend` und `RESEND_API_KEY=<Ihr-Schlüssel>` in `.env` und starten Sie dann das Backend neu:
+
+```sh
+docker compose restart backend
+```
+
+### MinIO-Bucket fehlt
+
+Wenn der `minio-init`-One-Shot-Service nicht ausgeführt wurde (oder vor der Bereitschaft von MinIO lief), erstellen Sie den Bucket manuell:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Nützliche Links
+
+- [Intlayer CMS-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md)
+- [Konfigurationsreferenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)