Intlayer Kendi Kendine Barındırma (Self-Hosting)

Intlayer, bir Intlayer Cloud hesabına ihtiyaç duymadan kendi altyapınızda çalışabilir. Aynı yükleyici (install.sh, Windows üzerinde install.ps1 veya npx intlayer init infra) ile yapılandırılabilen üç kurulum sunulmaktadır:

Table of Contents

Yayınlanan İmajlar ve Paketler

Her üç imaj da aynı docker/selfhost/Dockerfile dosyasından oluşturulur ve her sürümde yayınlanır. Compose yığını ayrıca resmi mongo:8, redis:8-alpine ve quay.io/minio/minio imajlarını çeker.

Kurulum

Yükleyici istediğiniz kurulumu sorar, önkoşulları kontrol eder (Docker kurulumunu önerir), önceden oluşturulmuş gizli anahtarlarla ortam dosyasını yazar ve imajları çeker. Kendi kendine hiçbir şey başlatmaz: Docker modları önce bir e-posta göndericisinin ayarlanmasını gerektirir, bu nedenle çalıştırılacak komutu yazdırarak tamamlanır. Tekrar çalıştırmak güvenlidir: mevcut bir ortam dosyasının üzerine asla yazılmaz, bu da onu bir güncelleme yolu haline getirir.

curl -fsSL https://intlayer.org/install.sh | sh -s -- --mode desktop

$env:INTLAYER_MODE = "desktop"; irm https://intlayer.org/install.ps1 | iex

npx intlayer init infra --mode desktop

                ┌─────────────────────────────┐
 browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
 (localhost)    └─────────────────────────────┘   │ VITE_BACKEND_URL (baked at build)
                ┌─────────────────────────────┐   │
                │  backend (Fastify/Bun)  :3100│ ◀─┘
                └──────────────┬──────────────┘
          ┌──────────┬─────────┼──────────────┐
          ▼          ▼         ▼               ▼
      mongo:27017  redis:6379  minio:9000   Chromium
      /data/mongo  /data/redis /data/minio  (in-image)
      (1-node RS)              minio:9001

curl -fsSL https://intlayer.org/install.sh | sh -s -- --mode docker

$env:INTLAYER_MODE = "docker"; irm https://intlayer.org/install.ps1 | iex

npx intlayer init infra --mode docker

# Option A: Resend
RESEND_API_KEY=<your-resend-key>

# Option B: SMTP (takes over from Resend as soon as MAIL_SMTP_HOST is set)
MAIL_SMTP_HOST=smtp.example.com
MAIL_SMTP_PORT=587
MAIL_SMTP_USER=<user>
MAIL_SMTP_PASSWORD=<password>
MAIL_FROM=Intlayer <no-reply@example.com>

docker run -d --name intlayer \
  --restart unless-stopped \
  -p 3000:3000 -p 3100:3100 -p 9000:9000 -p 9001:9001 \
  -v intlayer-data:/data \
  --env-file ./intlayer.env \
  intlayer/cms-all:latest

docker run -d --name intlayer `
  --restart unless-stopped `
  -p 3000:3000 -p 3100:3100 -p 9000:9000 -p 9001:9001 `
  -v intlayer-data:/data `
  --env-file ./intlayer.env `
  intlayer/cms-all:latest

# Backup (stop the container first so MongoDB's files are consistent)
docker stop intlayer
docker run --rm -v intlayer-data:/data -v "$(pwd)":/backup busybox tar czf /backup/intlayer-data.tar.gz /data
docker start intlayer

# Restore
docker run --rm -v intlayer-data:/data -v "$(pwd)":/backup busybox tar xzf /backup/intlayer-data.tar.gz -C /

                ┌───────────────────┐
 browser ──────▶ │  app        :3000 │ ── SSR ──▶ http://backend:3100
 (localhost)    └───────────────────┘
                ┌───────────────────┐
 browser ──────▶ │  backend    :3100 │
 (localhost)    └─────────┬─────────┘
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
     mongo:27017     redis:6379      minio:9000 ◀── browser (assets)
     (1-node RS)                     minio:9001

curl -fsSL https://intlayer.org/install.sh | sh -s -- --mode compose

mkdir intlayer && cd intlayer
curl -fsSLO https://raw.githubusercontent.com/aymericzip/intlayer/main/docker/selfhost/docker-compose.yml
curl -fsSL  https://raw.githubusercontent.com/aymericzip/intlayer/main/docker/selfhost/.env.template -o .env
# fill in BETTER_AUTH_SECRET and S3_SECRET_ACCESS_KEY (openssl rand -hex 32)

$env:INTLAYER_MODE = "compose"; irm https://intlayer.org/install.ps1 | iex

mkdir intlayer; cd intlayer
irm https://raw.githubusercontent.com/aymericzip/intlayer/main/docker/selfhost/docker-compose.yml -OutFile docker-compose.yml
irm https://raw.githubusercontent.com/aymericzip/intlayer/main/docker/selfhost/.env.template -OutFile .env
# fill in BETTER_AUTH_SECRET and S3_SECRET_ACCESS_KEY

npx intlayer init infra --mode compose

cd intlayer && docker compose up -d

services:
  backend:
    environment:
      MONGODB_URI: mongodb+srv://user:password@cluster0.xxxxx.mongodb.net/intlayer
      REDIS_URL: rediss://default:password@redis.example.com:6380
      S3_ENDPOINT: https://s3.eu-west-1.amazonaws.com
      S3_PUBLIC_URL: https://intlayer-assets.s3.eu-west-1.amazonaws.com

cd docker/selfhost
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

# Backup one volume (repeat for intlayer_redis-data and intlayer_minio-data)
docker compose stop
docker run --rm -v intlayer_mongo-data:/data -v "$(pwd)":/backup busybox tar czf /backup/mongo-data.tar.gz /data
docker compose start

# Upgrade, volumes are kept
docker compose pull && docker compose up -d

Yükleyici Ayarları

--mode (veya INTLAYER_MODE) belirtilmezse, yükleyici bir menü sunar: desktop, docker (hepsi-bir-arada) veya compose. Ayrıca birkaç ortam değişkenini de okur; bunlar kabuğa yönlendirildiği için curl yerine doğrudan kabuğa aktarılmalıdır:

curl -fsSL https://intlayer.org/install.sh | INTLAYER_COMPOSE_DIR=./cms sh -s -- --mode compose

$env:INTLAYER_MODE = "compose"; $env:INTLAYER_COMPOSE_DIR = ".\cms"; irm https://intlayer.org/install.ps1 | iex

Port değişkenleri yalnızca eşlemenin ana bilgisayar tarafını değiştirir. Yayınlanan imajlarda kontrol paneli paketine http://localhost:3000, http://localhost:3100 ve http://localhost:9000 derlenmiştir; bu nedenle kendi imajınızı derlemediğiniz sürece varsayılan değerleri koruyun, bkz. Sınırlamalar.

İlk Çalıştırma Kurulumu

Yeni bir örnekte (boş veritabanı) kontrol panelini açtığınızda otomatik olarak /init sayfasına yönlendirilirsiniz:

1. İlk hesabı oluşturun. Kullanıcı koleksiyonu boş olduğundan, bu hesap otomatik olarak Süper Yönetici yapılır.
2. Resend veya SMTP geçişiniz üzerinden bir doğrulama e-postası gönderilir. E-posta doğrulaması zorunludur; bu nedenle başlatmadan önce bir e-posta göndericisi yapılandırılmalıdır.
3. E-postadaki bağlantıya tıklayın ve giriş yapın.

Yönetici oluşturulduktan sonra /init adresi normal oturum açma sayfasına yönlendirilir.

Ortam Değişkenleri

Her iki Docker modu da docker/selfhost/.env.template dosyasından oluşturulan aynı dosyayı (kapsayıcı için intlayer.env, Compose için .env) okur.

Gerekli

Dağıtım Tarafından Sabitlenmiş

Bunlar imaj (hepsi-bir-arada) veya compose dosyası tarafından ayarlanır ve yalnızca standart dışı bir topoloji için geçersiz kılınmaları gerekir. DOMAIN, APP_URL, BACKEND_URL ve S3_PUBLIC_URL istisnadır: env dosyasında ayarlandıklarında her iki modda da önceliklidirler (bkz. Özel alan adı).

Compose app hizmeti ek olarak INTLAYER_BACKEND_INTERNAL_URL=http://backend:3100 alır: tarayıcı API'ye localhost:3100 üzerinden erişirken, sunucu tarafı işleme Compose ağı içinde çalışır ve bu nedenle hizmet adını kullanmalıdır.

Özel alan adı

Arka uç, genel URL'lerini çalışma zamanında okur, ancak kontrol panelinde bunlar derleme sırasında gömülüdür: yayınlanan intlayer/cms-frontend ve intlayer/cms-all imajları yalnızca http://localhost:3000 üzerinde çalışır. Bu nedenle Intlayer'ı kendi alan adınızda sunmak iki şey gerektirir; alan adı sorusunu yanıtladığınızda yükleyici her ikisini de hazırlar:

1. env dosyasında dört değişken; arka uç tarafından okunur (çerezler, e-posta bağlantıları, OAuth geri çağrıları, varlık URL'leri) ve docker-compose.build.yml tarafından derleme argümanları olarak kullanılır:

   intlayer.env

   İçeriği kopyala

   Kodu kopyala

   Kodu panoya kopyala

   DOMAIN=example.org                          # cookie domain, parent of the hosts below
   APP_URL=https://cms.example.org
   BACKEND_URL=https://back.example.org
   S3_PUBLIC_URL=https://s3.example.org/intlayer
   

2. Bu URL'lerle derlenmiş bir kontrol paneli imajı. Docker bunu doğrudan depodan derler, klon gerekmez:

   sh

   İçeriği kopyala

   Kodu kopyala

   Kodu panoya kopyala

   # Docker Compose: the override reads the build args from .env
   docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build
   
   # All-in-one
   docker build -f docker/selfhost/Dockerfile \
     --build-arg VITE_DOMAIN=example.org \
     --build-arg VITE_SITE_URL=https://cms.example.org \
     --build-arg VITE_IDE_URL=https://cms.example.org \
     --build-arg VITE_BACKEND_URL=https://back.example.org \
     -t intlayer/cms-all:custom \
     https://github.com/aymericzip/intlayer.git#main
   

Ardından kapsayıcının önüne TLS'li bir ters proxy koyun: cms.example.org → port 3000, back.example.org → 3100, s3.example.org → 9000. Oturum çerezi DOMAIN ile sınırlı olduğundan, üç ana bilgisayar bu soneki paylaşmalıdır.

İsteğe Bağlı (ayarlanmadığında özellikler sorunsuz bir şekilde devre dışı kalır)

Genel E-posta Göndericisi (Mailer)

Şifre sıfırlama ve sihirli bağlantılar dahil olmak üzere kuruluş dışı e-postalar da dahil tüm işlem e-postaları iki genel aktarımdan biri üzerinden gönderilir:

• Resend: RESEND_API_KEY kullanır.
• SMTP: MAIL_SMTP_* değişkenlerini kullanır. MAIL_SMTP_HOST ayarlandığı anda SMTP seçilir ve RESEND_API_KEY yok sayılır.

MAIL_PROVIDER yalnızca her ikisi de yapılandırıldığında bir aktarımı zorlamak için gereklidir (örneğin bir SMTP sunucusu mevcutken Resend'i korumak için MAIL_PROVIDER=resend).

Öncelik: Bir kuruluşun kendi e-posta göndericisi (Kuruluş kontrol panelinden yapılandırılır) genel e-posta göndericisini geçersiz kılar; genel e-posta göndericisi ise varsayılan Resend anahtarını geçersiz kılar.

Intlayer Projenizi Bağlama

Yığın çalıştırıldıktan sonra, projenizi intlayer.org yerine kendi barındırdığınız arka uca ve kontrol paneline işaret edecek şekilde yapılandırın.

Proje Yapılandırması

import type { IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  editor: {
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,

    /**
     * URL of the self-hosted CMS dashboard.
     * Default: https://app.intlayer.org
     */
    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000

    /**
     * URL of the self-hosted backend API.
     * Default: https://back.intlayer.org
     */
    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
  },
};

export default config;

Set the environment variables in your project's .env:

INTLAYER_CMS_URL=http://localhost:3000
INTLAYER_BACKEND_URL=http://localhost:3100
INTLAYER_CLIENT_ID=<your-client-id>
INTLAYER_CLIENT_SECRET=<your-client-secret>

Erişim kimlik bilgilerini kendi barındırdığınız kontrol panelinden oluşturun: Projeler → Erişim Anahtarları (http://localhost:3000/projects).

@intlayer/api SDK

@intlayer/api SDK'sını programlı olarak kullanırken backendURL parametresini açıkça iletin:

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();

Sınırlamalar

• Özel alan adı yeniden derleme demektir. Tarayıcıya yönelik tüm VITE_* URL'leri derleme sırasında kontrol paneline dahil edilir ve yayınlanan imajlar (ve masaüstü uygulaması) localhost / Intlayer Cloud değerleriyle yapılandırılmıştır. Varsayılan olarak kontrol paneline http://localhost:3000, API'ye :3100 ve MinIO'ya :9000 üzerinden erişilmelidir; ana bilgisayar portlarını yeniden eşlemek de aynı etkiyi yaratır. Bir alan adı verdiğinizde yükleyici, depodan yeniden derleme için her şeyi hazırlar (bkz. Özel alan adı), ancak derlemenin kendisi birkaç dakika sürer. Masaüstü uygulamasını kendi kendine barındırılan bir arka uca yönlendirmek desteklenmez.
• E-posta gönderimi çalışan bir gönderici gerektirir. İlk çalıştırma kurulumunda e-posta doğrulaması zorunlu olduğundan RESEND_API_KEY veya bir SMTP geçişi (MAIL_SMTP_*) yapılandırılmalıdır. İlk yönetici oturum açtıktan sonra kuruluşlar kontrol panelinden kendi SMTP veya Resend göndericilerini de yapılandırabilir.
• Masaüstü uygulaması yerleşik sunucuyu başlatmak için makinede Node.js gerektirir.
• Dokümantasyon asistanı yok. intlayer.org'un yapay zeka dokümantasyon asistanı (/api/ai/ask, /api/search/doc), kendi kendine barındırma imajlarında bulunmayan yaklaşık 130 MB önceden hesaplanmış dokümantasyon embedding'lerine dayanır; bu iki rota kendi kendine barındırılan modda kaydedilmez. Kontrol panelinin kendi yapay zeka özellikleri (çeviri, denetim, otomatik tamamlama, sohbet) etkilenmez ve yalnızca OPENAI_API_KEY gerektirir.

Faydalı Bağlantılar

• Intlayer CMS Belgeleri
• Yapılandırma Referansı
• CMS SDK: @intlayer/api
• Masaüstü Uygulaması Sürümleri
• Docker Hub: intlayer/cms-all, intlayer/cms-frontend, intlayer/cms-backend, GHCR yansıması: ghcr.io/aymericzip/intlayer/
• docker/selfhost/: Dockerfile, docker-compose.yml, .env.template