Intlayer のセルフホスティング

Intlayer は独自のインフラストラクチャ上で実行でき、Intlayer Cloud アカウントは不要です。同じインストーラー（install.sh、Windows では install.ps1、または npx intlayer init infra）でセットアップできる3つの構成が用意されています:

Table of Contents

公開イメージおよびパッケージ

3つのイメージはすべて同じ docker/selfhost/Dockerfile からビルドされ、リリースごとに公開されます。Compose スタックは公式の mongo:8、redis:8-alpine、quay.io/minio/minio イメージも取得します。

セットアップ

インストーラーは希望するセットアップを尋ね、前提条件を確認し（Dockerのインストールを提案）、生成済みのシークレットを含む環境ファイルを書き出し、イメージを取得します。自動で起動することはありません: Docker モードでは最初にメーラーが必要となるため、最後に実行すべきコマンドを出力して終了します。再実行は安全です: 既存の環境ファイルは上書きされないため、アップグレード時にも利用できます。

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

インストーラーの設定

--mode（または INTLAYER_MODE）を指定しない場合、インストーラーはメニューを表示します: desktop、docker（オールインワン）、または compose。また、いくつかの環境変数も読み取ります。シェルへのパイプライン処理を行うため、curl ではなくシェルに変数を渡してください:

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

ポート変数はマッピングの ホスト 側のみを変更します。公開されているイメージには http://localhost:3000、http://localhost:3100、http://localhost:9000 がダッシュボードバンドルにコンパイルされているため、独自のイメージをビルドしない限りデフォルトを維持してください。制限事項 を参照してください。

初回セットアップ

新規インスタンス（空のデータベース）でダッシュボードを開くと、自動的に /init ページにリダイレクトされます:

1. 最初のアカウントを作成します。ユーザーコレクションが空のため、このアカウントは自動的に スーパー管理者 に昇格します。
2. Resend または SMTP リレー経由で確認メールが送信されます。メール確認は 必須 です。そのため、起動前にメーラーを設定する必要があります。
3. メール内のリンクをクリックし、サインインします。

管理者が存在する場合、/init は通常のサインインページにリダイレクトされます。

環境変数

両方の Docker モードは、docker/selfhost/.env.template から生成された同じファイル（コンテナ用は intlayer.env、Compose 用は .env）を読み取ります。

必須項目

デプロイによって固定

これらはイメージ（オールインワン）または compose ファイルで設定され、標準的でない構成の場合にのみ上書きが必要です。ただし DOMAIN、APP_URL、BACKEND_URL、S3_PUBLIC_URL は例外で、env ファイルで設定すると両方のモードで優先されます（カスタムドメイン を参照）。

Compose の app サービスは追加で INTLAYER_BACKEND_INTERNAL_URL=http://backend:3100 を受け取ります: ブラウザは localhost:3100 で API にアクセスしますが、サーバーサイドレンダリングは Compose ネットワーク内で実行されるため、サービス名を使用する必要があります。

カスタムドメイン

バックエンドは公開 URL を実行時に読み込みますが、ダッシュボードではそれらがコンパイル時に組み込まれています。公開されている intlayer/cms-frontend および intlayer/cms-all イメージは http://localhost:3000 でしか動作しません。そのため、独自のドメインで Intlayer を提供するには次の2つが必要です。どちらも、ドメインの質問に回答するとインストーラーが準備します:

1. env ファイル内の4つの変数。バックエンドが読み込み（Cookie、メールのリンク、OAuth コールバック、アセット URL）、docker-compose.build.yml がビルド引数として使用します:

   intlayer.env

   コンテンツをコピー

   コードをコピー

   コードをクリップボードにコピー

   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. これらの URL でビルドしたダッシュボードイメージ。 Docker はリポジトリから直接ビルドするため、クローンは不要です:

   sh

   コンテンツをコピー

   コードをコピー

   コードをクリップボードにコピー

   # 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
   

次に、TLS 対応のリバースプロキシをコンテナの前に配置します: cms.example.org → ポート 3000、back.example.org → 3100、s3.example.org → 9000。セッション Cookie のスコープが DOMAIN に限定されるため、3つのホストはこのサフィックスを共有する必要があります。

オプション（設定しない場合でも機能は正常にフォールバックします）

グローバルメーラー

パスワードのリセットやマジックリンクなど、組織外のメールを含むすべてのトランザクションメールは、次の2つのグローバルトランスポートのいずれかを経由します:

• Resend: RESEND_API_KEY を使用。
• SMTP: MAIL_SMTP_* 変数を使用。MAIL_SMTP_HOST が設定されると直ちに SMTP が使用され、RESEND_API_KEY は無視されます。

MAIL_PROVIDER は、両方が構成されている場合に一方のトランスポートを強制するためにのみ必要です（たとえば、SMTP ホストが存在する場合に Resend を維持するために MAIL_PROVIDER=resend）。

優先順位: 組織独自のメーラー（組織 ダッシュボードから構成）はグローバルメーラーよりも優先され、グローバルメーラーはデフォルトの Resend キーよりも優先されます。

Intlayer プロジェクトの接続

スタックが実行されたら、intlayer.org ではなく、セルフホストされたバックエンドとダッシュボードを指すようにプロジェクトを設定します。

プロジェクト設定

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>

セルフホストダッシュボードの Projects → Access keys (http://localhost:3000/projects) でアクセス資格情報を作成します。

@intlayer/api SDK

プログラムで @intlayer/api SDK を使用する場合、backendURL を明示的に渡します:

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

制限事項

• カスタムドメインにはリビルドが必要。 ブラウザ向けのすべての VITE_* URL はビルド時にダッシュボードに組み込まれ、公開イメージ（およびデスクトップアプリ）には localhost / Intlayer Cloud の値が設定されています。初期状態では、ダッシュボードは http://localhost:3000、API は :3100、MinIO は :9000 でアクセスする必要があり、ホストポートを再マッピングしても同じ結果になります。ドメインを指定すると、インストーラーはリポジトリからのリビルドに必要なものをすべて準備しますが（カスタムドメイン を参照）、ビルド自体には数分かかります。デスクトップアプリをセルフホストバックエンドに向けることはサポートされていません。
• メール送信には機能するメーラーが必要です。 初回セットアップではメール確認が必須となるため、RESEND_API_KEY または SMTP リレー (MAIL_SMTP_*) のいずれかを構成する必要があります。最初の管理者がサインインした後、各組織はダッシュボードから独自の SMTP または Resend メーラーを構成することもできます。
• デスクトップアプリは組み込みサーバーを起動するためにマシン上に Node.js を必要とします。
• ドキュメントアシスタントなし。 intlayer.org の AI ドキュメントアシスタント（/api/ai/ask、/api/search/doc）は、セルフホストイメージに含まれていない約 130 MB の事前計算済みドキュメント埋め込みに依存しているため、セルフホストモードではこの2つのルートは登録されません。ダッシュボード自体の AI 機能（翻訳、監査、オートコンプリート、チャット）には影響がなく、OPENAI_API_KEY のみが必要です。

便利なリンク

• Intlayer CMS ドキュメント
• 設定リファレンス
• CMS SDK: @intlayer/api
• デスクトップアプリのリリース
• Docker Hub: intlayer/cms-all, intlayer/cms-frontend, intlayer/cms-backend、GHCR ミラー: ghcr.io/aymericzip/intlayer/
• docker/selfhost/: Dockerfile、docker-compose.yml、.env.template