Self-Hosting Intlayer

Intlayer dapat berjalan sepenuhnya di infrastruktur Anda sendiri — tidak memerlukan akun Intlayer Cloud. Satu perintah akan mem-boot stack yang siap produksi:

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

Installer mengunduh docker-compose.yml dan .env, membuat secret yang diperlukan secara otomatis, dan memulai semua kontainer dengan docker compose up -d.

Daftar Isi

Arsitektur

                ┌─────────────────────────────┐ 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 (digunakan untuk pembuatan screenshot Puppeteer) dibundel di dalam image backend — tidak diperlukan kontainer terpisah.

Prasyarat

• Docker ≥ 24 dan Docker Compose ≥ v2. Jika salah satunya tidak ada, installer akan mencetak tautan instalasi dan keluar.
• Port 3000, 3100, 8025, 9000, dan 9001 tersedia di host.
• Host Linux atau macOS (atau WSL2 di Windows).

Memulai Cepat

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

Apa yang dilakukan installer:

1. Memeriksa bahwa docker dan docker compose ada.
2. Mengunduh docker-compose.yml dan .env.example ke ./intlayer/.
3. Jika tidak ada .env yang ada, menyalin contoh dan menghasilkan secret acak untuk BETTER_AUTH_SECRET, S3_ACCESS_KEY_ID, dan S3_SECRET_ACCESS_KEY melalui openssl rand.
4. Menjalankan docker compose pull + docker compose up -d.
5. Mencetak URL: dashboard :3000, API :3100, UI email :8025, konsol MinIO :9001.

Setelah stack aktif, buka http://localhost:3000 dan buat akun pertama Anda.

Layanan

Port internal (mongo, redis) tidak terekspos ke host secara default.

Port MinIO 9000 harus dapat dijangkau oleh browser karena aset yang diunggah (avatar, screenshot) dimuat langsung dari S3_PUBLIC_URL=http://localhost:9000/intlayer.

Variabel Lingkungan

Installer menghasilkan .env yang siap pakai. Tabel di bawah ini menjelaskan setiap variabel.

Wajib (dibuat secara otomatis atau diminta)

Opsional (fitur akan menurun secara bertahap jika tidak ada)

Menghubungkan proyek Intlayer Anda

Setelah stack berjalan, arahkan proyek Anda ke backend dan dashboard yang di-self-host, bukan ke intlayer.org.

Konfigurasi proyek

import type { IntlayerConfig } from "intlayer";

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

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

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

export default config;

Setel variabel lingkungan di .env proyek Anda:

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

Buat kredensial akses di dashboard self-host Anda di bawah Projects → Access keys di http://localhost:3000/projects.

@intlayer/api SDK

Saat menggunakan @intlayer/api SDK secara terprogram, teruskan backendURL secara eksplisit:

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

Peningkatan

Menjalankan ulang installer pada deployment yang ada akan melakukan rolling upgrade:

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

Ini menarik image terbaru dan memulai ulang kontainer dengan docker compose pull && docker compose up -d. Volume yang sudah ada (mongo-data, redis-data, minio-data) dipertahankan — tidak ada kehilangan data.

Untuk meningkatkan secara manual dari dalam direktori ./intlayer/:

docker compose pulldocker compose up -d

Cadangkan dan pulihkan

Semua data persisten berada dalam tiga volume Docker bernama.

Cadangkan

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

Pulihkan

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar xzf /backup/mongo-data.tar.gz -C /# Ulangi untuk redis-data dan minio-data

Menggunakan reverse proxy (Nginx / Caddy)

Untuk deployment produksi, letakkan reverse proxy di depan kontainer aplikasi dan backend daripada mengeksposnya secara langsung.

Contoh 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;    }}

Perbarui variabel .env berikut agar sesuai dengan domain publik Anda:

BACKEND_URL=https://api.example.comAPP_URL=https://cms.example.comDOMAIN=example.comVITE_BACKEND_URL=https://api.example.comVITE_DOMAIN=example.com

Variabel VITE_* tertanam dalam image dashboard pada waktu build. Jika Anda mengubahnya setelah image dibuat, Anda perlu membangun ulang image app (docker compose build app) atau menggunakan injeksi konfigurasi runtime.

Pemecahan Masalah

Backend crash-loops pada start pertama

MongoDB dan Redis harus sehat sebelum backend dimulai. File compose menggunakan depends_on dengan condition: service_healthy. Jika Anda melihat restart backend berulang, periksa apakah healthchecks mongo dan redis lulus:

docker compose psdocker compose logs mongodocker compose logs redis

Dashboard tidak dapat mencapai API

Verifikasi bahwa VITE_BACKEND_URL cocok dengan URL di mana backend dapat dijangkau dari browser (bukan jaringan Docker). Jika Anda mengubah port backend atau menambahkan reverse proxy, bangun ulang image dashboard:

docker compose build appdocker compose up -d app

Email tidak terkirim

Secara default, semua email keluar ditangkap oleh Mailpit. Buka http://localhost:8025 untuk melihat pesan yang terkirim. Untuk mengirim email sungguhan, setel MAIL_PROVIDER=resend dan RESEND_API_KEY=<your-key> di .env, lalu restart backend:

docker compose restart backend

Bucket MinIO hilang

Jika layanan one-shot minio-init tidak berjalan (atau berjalan sebelum MinIO siap), buat bucket secara manual:

docker compose run --rm minio-init

Tautan Berguna

• Dokumentasi Intlayer CMS
• Referensi Konfigurasi
• SDK CMS — @intlayer/api