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:

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

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

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.

Erstmalige Einrichtung

Bei einer frischen Instanz (leere Datenbank) leitet Sie das Öffnen des Dashboards zur Seite /init weiter:

1. Erstellen Sie das erste Konto. Da die users-Collection leer ist, wird dieses Konto automatisch zum super admin befördert.
2. Eine Verifizierungs-E-Mail wird gesendet (über Resend). E-Mail-Verifizierung ist erforderlich — deshalb muss RESEND_API_KEY vor dem Start gesetzt werden.
3. Klicken Sie auf den Link in der E-Mail und melden Sie sich an.

Sobald ein Admin existiert, leitet /init zur Standard-Anmeldeseite weiter.

Dienste

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

Erforderlich

Erforderlich (automatisch generiert oder abgefragt)

Optional (Funktionen funktionieren bei Abwesenheit eingeschränkt)

Global mailer

By default, all transactional emails are sent through Resend using RESEND_API_KEY. Self-hosted deployments can instead route every email — including non-organization emails such as password resets and magic links — through a global mailer configured with environment variables.

Set MAIL_PROVIDER to activate it. When unset, the default Resend mailer is used.

Precedence: an organization's own mailer (configured from the Organization dashboard) takes priority over the global mailer, which in turn takes priority over the default Resend key.

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

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:

INTLAYER_CMS_URL=http://localhost:3000INTLAYER_BACKEND_URL=http://localhost:3100INTLAYER_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:

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:

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:

docker compose pulldocker compose up -d

Backup und Wiederherstellung

Alle persistenten Daten befinden sich in drei benannten Docker-Volumes.

Backup

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/mongo-data.tar.gz /datadocker run --rm \  -v intlayer_redis-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/redis-data.tar.gz /datadocker run --rm \  -v intlayer_minio-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/minio-data.tar.gz /data

Wiederherstellung

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

Einschränkungen

• MongoDB muss extern sein (Atlas). Das Backend verbindet sich nur über mongodb+srv:// (zusammengesetzt aus DB_ID / DB_MDP / DB_CLUSTER), daher kann ein einfaches mongodb://host:27017 — einschließlich des eigenen mongod des Containers — nicht verwendet werden. Stellen Sie einen MongoDB Atlas Cluster bereit.
• Keine benutzerdefinierte Domain. Alle browsergestützten VITE_* URLs werden zur Build-Zeit in die App inline eingefügt, und das veröffentlichte Image wird mit localhost Werten ausgeliefert. Das Dashboard muss unter http://localhost:3000 aufgerufen werden; das Serving auf einer öffentlichen Domain würde ein Neubau des Images mit den eingebetteten Ziel-URLs erfordern und wird out-of-the-box nicht unterstützt.
• E-Mail erfordert einen funktionierenden Mailer. Das Setup beim ersten Durchlauf erzwingt eine E-Mail-Verifizierung, daher muss entweder RESEND_API_KEY oder ein globaler SMTP Mailer (MAIL_PROVIDER=smtp + MAIL_SMTP_*) konfiguriert sein. Nach der ersten Anmeldung eines Administrators kann jede Organisation auch ihren eigenen SMTP oder Resend Mailer vom Dashboard aus konfigurieren.

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:

docker compose psdocker compose logs mongodocker compose logs redis

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:

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:

docker compose run --rm minio-init

Nützliche Links

• Intlayer CMS-Dokumentation
• Konfigurationsreferenz
• CMS SDK — @intlayer/api
• Docker Image (aymercizip/intlayer-selfhost)