Intlayerのセルフホスティング

Intlayerはあなた自身のインフラストラクチャ上で実行できます。Intlayer Cloudアカウントは必要ありません。単一のオールインワンDockerイメージは、ダッシュボード、API、および必要なローカルデータストア（RedisとMinIO）をバンドルし、s6-overlayによって監視されています。

Intlayerは、Intlayer Cloudアカウントを必要とせず、独自のインフラストラクチャ上で完全に実行できます。単一のコマンドで、本番環境に対応したスタックを起動します。

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

インストーラーは docker-compose.yml と .env をダウンロードし、必要なシークレットを自動生成して、すべてのコンテナを docker compose up -d で起動します。

唯一の外部依存関係は MongoDB です。バックエンドは提供する MongoDB Atlas クラスターに接続します。その他すべてはコンテナ内で実行されます。

目次

アーキテクチャ

                ┌─────────────────────────────┐
 browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
                └─────────────────────────────┘   │ VITE_BACKEND_URL
                ┌─────────────────────────────┐   │
                │  backend (Fastify/Bun)  :3100│ ◀─┘
                └──────────────┬──────────────┘
          ┌──────────┬─────────┼──────────┬───────────┐
          ▼          ▼         ▼          ▼           ▼
     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
     (1ノードRS)             (S3 API)     (SMTP)        (インイメージ)
                             minio:9001   mailpit:8025
                             (コンソール) (ウェブUI)

Chromium (Puppeteerのスクリーンショット生成に使用) はバックエンドイメージ内にバンドルされており、別のコンテナは必要ありません。

前提条件

• Docker ≥ 24 および Docker Compose ≥ v2。いずれかが不足している場合、インストーラーはインストールリンクを表示して終了します。
• ホスト上でポート 3000、3100、8025、9000、9001 が利用可能であること。
• LinuxまたはmacOSホスト（またはWindows上のWSL2）。

その他すべて — Bun、Redis、MinIO、Chromium — はイメージ内に含まれています。

クイックスタート

1. インストーラーを実行する

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

Docker がインストールされており実行中であることを確認し、既に生成された BETTER_AUTH_SECRET と S3_SECRET_ACCESS_KEY を含む ./intlayer.env を書き込み、イメージをプルします。コンテナを起動しません — バックエンドはデータベース認証情報がないとブートできません。

インストーラーを再実行しても安全です。既存の intlayer.env は上書きされないため、アップグレードパスとしても機能します。

2. 認証情報を入力する

intlayer.env を開き、TODO でマークされている値を入力してください：

DB_ID=<atlas-user>
DB_MDP=<atlas-password>
DB_CLUSTER=<cluster>.xxxxx.mongodb.net
RESEND_API_KEY=<your-resend-key>

ファイルには、オプション機能のためのコメントアウトされたブロックも含まれています — SMTP mailer、OPENAI_API_KEY、および OAuth プロバイダー。必要なものをコメント解除してください。

ファイルは docker run --env-file によって読み込まれ、クォートを削除せず、= の後のすべてを値として扱います。クォートなしの値を書き、コメントは独立した行に保つようにしてください。

3. コンテナを起動する

インストーラーが完了時に出力するコマンドは次の通りです:

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 \
  ghcr.io/aymericzip/intlayer-selfhost:latest

その後、http://localhost:3000 を開きます。初回起動時はデータストアが初期化されるため、1 分ほど待ってください。

ダッシュボードは localhost で提供されます。制限事項を参照してください。公開されているイメージではカスタムドメインはサポートされていません。

インストーラー設定

インストーラーは環境変数をいくつか読み込みます。sh にパイプされるため、curl ではなくシェルに環境変数を渡してください:

curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh

4 つのポート変数は、docker run コマンドで出力されるマッピングのホスト側のみを変更します。公開されたイメージには、http://localhost:3000、http://localhost:3100、http://localhost:9000 がビルド時にダッシュボード bundle にコンパイルされているため、これらをリマップするとブラウザーが古いポートを指し続けます。独自のイメージをビルドしていない限り、デフォルトを保持してください — 制限事項を参照してください。

初回セットアップ

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

1. 最初のアカウントを作成します。ユーザーコレクションが空のため、このアカウントは自動的に super admin に昇格されます。
2. 検証メールが送信されます（Resend経由）。メール検証は 必須 です — これが RESEND_API_KEY を開始前に設定する必要がある理由です。
3. メール内のリンクをクリックしてサインインします。

管理者が存在すると、/init は標準的なサインインページにリダイレクトされます。

サービス

MinIOポート 9000 は、アップロードされたアセット (アバター、スクリーンショット) が S3_PUBLIC_URL=http://localhost:9000/intlayer から直接読み込まれるため、ブラウザから到達可能である必要があります。

環境変数

必須

必須 (自動生成またはプロンプトによる入力)

オプション (存在しない場合でも機能は正常に劣化します)

グローバルメーラー

デフォルトでは、すべてのトランザクションメールは RESEND_API_KEY を使用して Resend 経由で送信されます。セルフホストされたデプロイメントでは、パスワードリセットやマジックリンクなどの非組織メールを含むすべてのメールを、環境変数で設定されたグローバルメーラー経由でルーティングできます。

MAIL_PROVIDER を設定して有効にしてください。設定されていない場合は、デフォルトの Resend メーラーが使用されます。

優先順位: 組織独自のメーラー (Organization ダッシュボードから設定) が優先され、次にグローバルメーラーが優先され、最後にデフォルトの 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,

    /**
     * 自己ホスト型CMSダッシュボードのURL。
     * デフォルト: https://app.intlayer.org
     */
    cmsURL: process.env.INTLAYER_CMS_URL, // 例: http://localhost:3000

    /**
     * 自己ホスト型バックエンドAPIのURL。
     * デフォルト: https://back.intlayer.org
     */
    backendURL: process.env.INTLAYER_BACKEND_URL, // 例: http://localhost:3100
  },
};

export default config;

プロジェクトの .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();

アップグレード

これにより、最新のイメージがプルされ、docker compose pull && docker compose up -d でコンテナが再起動されます。既存のボリューム (mongo-data、redis-data、minio-data) は保持され、データ損失はありません。

docker compose pull
docker compose up -d

バックアップと復元

すべての永続データは、3つの名前付きDockerボリュームに保存されます。

バックアップ

docker run --rm \
  -v intlayer_mongo-data:/data \
  -v "$(pwd)":/backup \
  busybox tar czf /backup/mongo-data.tar.gz /data

docker run --rm \
  -v intlayer_redis-data:/data \
  -v "$(pwd)":/backup \
  busybox tar czf /backup/redis-data.tar.gz /data

docker run --rm \
  -v intlayer_minio-data:/data \
  -v "$(pwd)":/backup \
  busybox tar czf /backup/minio-data.tar.gz /data

復元

docker run --rm \
  -v intlayer_mongo-data:/data \
  -v "$(pwd)":/backup \
  busybox tar xzf /backup/mongo-data.tar.gz -C /

# redis-data と minio-data についても同様に繰り返します

制限事項

• MongoDB は外部 (Atlas) である必要があります。 バックエンドは mongodb+srv:// 経由でのみ接続します (DB_ID / DB_MDP / DB_CLUSTER から構築)。したがって、プレーンな mongodb://host:27017 — コンテナにバンドルされた mongod を含む — は使用できません。MongoDB Atlas クラスタを提供してください。
• カスタムドメインはサポートされていません。 すべてのブラウザ向け VITE_* URL はビルド時にアプリにインラインされ、公開されたイメージには localhost の値が付属します。ダッシュボードには http://localhost:3000 でアクセスする必要があります。パブリックドメインでサービスするには、イメージをターゲット URL を焼き込んで再構築する必要があり、そのままではサポートされていません。
• メールは機能するメーラーが必要です。 初回実行セットアップではメール検証が強制されるため、RESEND_API_KEY または グローバル SMTP メーラー (MAIL_PROVIDER=smtp + MAIL_SMTP_*) を設定する必要があります。最初の管理者がサインインした後、各組織はダッシュボードから独自の SMTP または Resend メーラーを設定することもできます。

トラブルシューティング

最初の起動時にバックエンドがクラッシュループする

バックエンドが起動する前に、MongoDBとRedisが正常である必要があります。composeファイルは condition: service_healthy とともに depends_on を使用しています。バックエンドの再起動が繰り返される場合は、mongo と redis のヘルスチェックがパスしているか確認してください。

docker compose ps
docker compose logs mongo
docker compose logs redis

ログの上部付近で MongoDB connection error を探してください。

メールが送信されない

デフォルトでは、すべての送信メールはMailpitによって捕捉されます。送信されたメッセージを確認するには、http://localhost:8025 を開いてください。実際のメールを送信するには、.env で MAIL_PROVIDER=resend と RESEND_API_KEY=<your-key> を設定し、バックエンドを再起動します。

MinIOバケットが見つからない

minio-init ワンショットサービスが実行されなかった場合 (またはMinIOが準備できる前に実行された場合) は、手動でバケットを作成してください。

docker compose run --rm minio-init

役立つリンク

• Intlayer CMS ドキュメント
• 設定リファレンス
• CMS SDK — @intlayer/api
• Docker Image (aymercizip/intlayer-selfhost)