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).

Mulai Cepat

Pull dan jalankan image yang dipublikasikan, dengan menyediakan kredensial dan secrets MongoDB Atlas Anda:

docker run -d --name intlayer \  -p 3000:3000 \  -p 3100:3100 \  -p 9000:9000 \  -p 9001:9001 \  -v intlayer-data:/data \  -e DB_ID="<atlas-user>" \  -e DB_MDP="<atlas-password>" \  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \  -e RESEND_API_KEY="<your-resend-key>" \  aymericzip/intlayer-selfhost

Kemudian buka http://localhost:3000.

Dashboard disajikan di localhost. Lihat Batasan — domain kustom tidak didukung oleh image yang dipublikasikan.

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

Diperlukan

Wajib (dibuat secara otomatis atau diminta)

Opsional (fitur akan menurun secara bertahap jika tidak ada)

Global mailer

Secara default, semua email transaksional dikirim melalui Resend menggunakan RESEND_API_KEY. Deployment yang self-hosted dapat mengarahkan setiap email — termasuk email non-organisasi seperti reset password dan magic links — melalui global mailer yang dikonfigurasi dengan environment variables.

Atur MAIL_PROVIDER untuk mengaktifkannya. Ketika tidak diatur, mailer Resend default digunakan.

Precedence: mailer milik organisasi sendiri (dikonfigurasi dari dashboard Organization) mengambil prioritas atas global mailer, yang pada gilirannya mengambil prioritas atas kunci Resend default.

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

Keterbatasan

• MongoDB harus external (Atlas). Backend terhubung hanya melalui mongodb+srv:// (dibangun dari DB_ID / DB_MDP / DB_CLUSTER), jadi plain mongodb://host:27017 — termasuk mongod bundled container sendiri — tidak dapat digunakan. Sediakan cluster MongoDB Atlas.
• Tidak ada custom domain. Semua URL VITE_* yang dihadapi browser di-inline ke dalam app pada saat build, dan image yang dipublikasikan dilengkapi dengan nilai localhost. Dashboard harus diakses di http://localhost:3000; melayaninya di domain publik memerlukan rebuilding image dengan target URLs yang tertanam dan tidak didukung out of the box.
• Email memerlukan mailer yang berfungsi. Setup first-run menerapkan verifikasi email, jadi baik RESEND_API_KEY atau global SMTP mailer (MAIL_PROVIDER=smtp + MAIL_SMTP_*) harus dikonfigurasi. Setelah admin pertama masuk, setiap organisasi juga dapat mengonfigurasi SMTP atau Resend mailer-nya sendiri dari dashboard.

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

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
• Docker Image (aymercizip/intlayer-selfhost)