Intlayerのセルフホスティング

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

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

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

目次

アーキテクチャ

                ┌─────────────────────────────┐ 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）。

クイックスタート

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

インストーラーの動作:

1. docker と docker compose が存在するかどうかを確認します。
2. docker-compose.yml と .env.example を ./intlayer/ にダウンロードします。
3. .env が存在しない場合、例をコピーし、BETTER_AUTH_SECRET、S3_ACCESS_KEY_ID、S3_SECRET_ACCESS_KEY 用に openssl rand を介してランダムなシークレットを生成します。
4. docker compose pull + docker compose up -d を実行します。
5. URLを表示します: ダッシュボード :3000、API :3100、メールUI :8025、MinIOコンソール :9001。

スタックが起動したら、http://localhost:3000 を開き、最初のIntlayerアカウントを作成してください。

初回セットアップ

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

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

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

サービス

内部ポート (mongo, redis) は、デフォルトではホストに公開されません。

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

アップグレード

既存のデプロイメントでインストーラーを再実行すると、ローリングアップグレードが実行されます。

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

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

./intlayer/ ディレクトリ内で手動でアップグレードするには:

docker compose pulldocker compose up -d

バックアップと復元

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

バックアップ

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

復元

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

メールが送信されない

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

docker compose restart backend

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

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

docker compose run --rm minio-init

役立つリンク

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