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:

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

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ıç

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.

İlk çalıştırma kurulumu

Yeni bir instance'ta (boş veritabanı), dashboard'u açmak sizi /init sayfasına yönlendirir:

1. İlk hesabı oluşturun. Kullanıcılar koleksiyonu boş olduğundan, bu hesap otomatik olarak super admin olarak yükseltilir.
2. Bir doğrulama e-postası gönderilir (Resend aracılığıyla). E-posta doğrulaması zorunludur — bu nedenle RESEND_API_KEY başlamadan önce ayarlanmalıdır.
3. E-postadaki bağlantıyı tıklayın, ardından oturum açın.

Bir admin mevcut olduğunda, /init standart oturum açma sayfasına yönlendirilir.

Servisler

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

Gerekli

Gerekli (otomatik oluşturulur veya istenir)

İsteğe Bağlı (yokluğunda özellikler sorunsuz şekilde bozulur)

Global mailer

Varsayılan olarak, tüm işlemsel e-postalar Resend üzerinden RESEND_API_KEY kullanılarak gönderilir. Self-hosted dağıtımlar bunun yerine tüm e-postaları — şifre sıfırlamaları ve magic linkler gibi organizasyon dışı e-postalar dahil — ortam değişkenleriyle yapılandırılmış global bir mailer üzerinden yönlendirebilir.

Etkinleştirmek için MAIL_PROVIDER ayarlayın. Ayarlanmadığında, varsayılan Resend mailer kullanılır.

Öncelik: bir organizasyonun kendi mailer'ı (Organization panosundan yapılandırılmış) global mailer'dan daha yüksek önceliğe sahiptir ve bu da varsayılan Resend anahtarından daha yüksek önceliğe sahiptir.

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ı

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:

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

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:

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:

docker compose pulldocker compose up -d

Yedekleme ve Geri Yükleme

Tüm kalıcı veriler, üç adet adlandırılmış Docker biriminde bulunur.

Yedekleme

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

Geri Yükleme

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

Sınırlamalar

• MongoDB harici (Atlas) olmalıdır. Backend yalnızca mongodb+srv:// üzerinden bağlanır (DB_ID / DB_MDP / DB_CLUSTER öğesinden oluşturulur), bu nedenle düz mongodb://host:27017 — konteyner'ın kendi paketlenmiş mongod dahil — kullanılamaz. Bir MongoDB Atlas kümesi sağlayın.
• Özel alan adı yok. Tüm tarayıcıya yönelik VITE_* URL'leri derleme zamanında uygulamaya satır içine alınır ve yayınlanan görüntü localhost değerleriyle gemi. Pano şu adreste erişilmelidir: http://localhost:3000; bunu genel bir alan adında sunmak, görüntüyü hedef URL'ler ile yeniden oluşturmayı gerektiriyor ve kutudan hemen çıkar desteklenmiyor.
• E-posta çalışan bir postacı gerektirir. İlk çalıştırma kurulumu e-posta doğrulamasını uygular, bu nedenle RESEND_API_KEY veya bir global SMTP postacısı (MAIL_PROVIDER=smtp + MAIL_SMTP_*) yapılandırılmalıdır. İlk yönetici oturum açtıktan sonra, her kuruluş panodan kendi SMTP veya Resend postacısını da yapılandırabilir.

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:

docker compose psdocker compose logs mongodocker 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:

docker compose build appdocker compose up -d app

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:

docker compose run --rm minio-init

Faydalı Bağlantılar

• Intlayer CMS belgeleri
• Yapılandırma referansı
• CMS SDK — @intlayer/api
• Docker Image (aymercizip/intlayer-selfhost)