OSS で始める

GitPod

Logto のオンライン GitPod ワークスペースを開始するには、こちらをクリックしてください。少し待つと、次のようなメッセージが表示されます：

Logto は、コアサービス用にポート 3001、インタラクティブな管理コンソール用にポート 3002 をデフォルトで使用します。

Logto の利用を続けるには、Ctrl（または Cmd）を押しながら https://3002-... で始まるリンクをクリックしてください。お楽しみください！

ローカル

Logto をホスティングするための最小推奨ハードウェア要件は以下の通りです：

• vCPU：2
• メモリ：8 GiB
• ディスク：256 GiB

Docker Compose

Docker Compose CLI は通常、Docker Desktop に付属しています。

注意:

本番環境では当社の docker compose コマンドを使用しないでください！現在、docker-compose.yml には Logto アプリと一緒に組み込みの Postgres データベースがバンドルされているため、コマンドを再実行するたびに新しいデータベースインスタンスが作成され、以前に保存されたデータはすべて失われます。

curl -fsSL https://raw.githubusercontent.com/logto-io/logto/HEAD/docker-compose.yml | docker compose -p logto -f - up

正常に構成されると、次のようなメッセージが表示されます：

Docker

ステップ 1

PostgreSQL@^14.0 インスタンスを用意し、Logto CLI を使って Logto 用のデータベースをシードします：

CLI

logto db seed

npx

npx @logto/cli db seed

ステップ 2

イメージをプルします：

# ghcr
docker pull ghcr.io/logto-io/logto:latest
# DockerHub
docker pull svhd/logto:latest

ステップ 3

コンテナのポートを Logto コアおよび管理アプリにマッピングします（例：3001:3001 および 3002:3002）。また、以下の環境変数をコンテナに設定します：

TRUST_PROXY_HEADER: 1 # Logto の前に HTTPS プロキシ（例：Nginx）がある場合は 1 に設定
ENDPOINT: https://<your-logto-domain> # （オプション）カスタムドメインを使用する場合は Logto エンドポイント URL に置き換え
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # （オプション）カスタムドメインを使用する場合は Logto 管理 URL に置き換え
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Postgres DSN に置き換え
DATABASE_STATEMENT_TIMEOUT: DISABLE_TIMEOUT # (v1.36.0+) PgBouncer/RDS Proxy 用に statement_timeout を無効化

上記の必須環境変数（オプションは省略、必要に応じて追加）でコンテナを実行します：

docker run \
  --name logto \
  -p 3001:3001 \
  -p 3002:3002 \
  -e TRUST_PROXY_HEADER=1 \
  -e ENDPOINT=https://<your-logto-domain> \
  -e ADMIN_ENDPOINT=https://<your-logto-admin-domain> \
  -e DB_URL=postgres://username:password@your_postgres_url:port/db_name \
  ghcr.io/logto-io/logto:latest

ヒント:

• Docker Hub を使用する場合は、ghcr.io/logto-io/logto:latest の代わりに svhd/logto:latest を使用してください。
• DB_URL でホスト IP を参照するには host.docker.internal または 172.17.0.1 を使用してください。
• PgBouncer や RDS Proxy を使用していて unsupported startup parameter: statement_timeout が表示される場合は、DATABASE_STATEMENT_TIMEOUT=DISABLE_TIMEOUT（v1.36.0+）を設定してください。

最後に、次のようなメッセージが表示されます：

npm-init

前提条件

• Node.js ^22.14.0
• PostgreSQL ^14.0

より高いバージョンでも通常は動作しますが、保証はありません。

Logto 専用の新しい空のデータベースを使用することを推奨しますが、必須ではありません。

ダウンロードと起動

ターミナルで：

npm init @logto@latest

初期化プロセスを完了し Logto を起動すると、次のようなメッセージが表示されます：

Core app is running at http://localhost:3001
Core app is running at https://your-domain-url
Admin app is running at http://localhost:3002
Admin app is running at https://your-admin-domain-url

http://localhost:3002/ にアクセスして Logto の利用を続けてください。お楽しみください！

ダウンロード用の代替 URL を使用する

Logto の zip ファイルの URL を指定したい場合は、--download-url オプションを使用します。例：

npm init @logto@latest -- --download-url=https://github.com/logto-io/logto/releases/download/v1.2.2/logto.tar.gz

NPM で引数を渡すためには、追加の -- が必要です。

設定（オプション）

Logto は環境変数による設定を採用しており、.env ファイルにも対応しています。詳細な使い方や全変数リストは 設定 を参照してください。

より高度な制御やプログラムによるアクセスが必要な場合は、コアサービス をご覧ください。

ホスティングプロバイダー

これらの信頼できるホスティングプロバイダーは、Logto のワンクリックインストールテンプレートを提供しています。簡単にデプロイできるサービスで、Logto を使った CIAM システムを数秒でセットアップ・起動できます。

Logto Cloud

無料の開発テナント付きで、認証 (Authentication) 統合が簡単なコスト効率の高いクラウドサービス。

Coolify

アプリやデータベース管理が簡単な、セルフホスト型 Heroku/Netlify 代替サービス。

Dokploy

独自インフラ上でアプリをデプロイできる軽量ツール。

Easypanel

Docker でクラウドサーバーを管理できる最新のコントロールパネル。

Elestio

コードやオープンソースソフトウェアをデプロイできる完全管理型 DevOps プラットフォーム。

Railway

アプリのデプロイやインフラ管理を簡素化します。

Zeabur

アプリのデプロイ・スケーリング・監視を開発者向けに簡単化します。

サードパーティサービスプロバイダーに関するカスタマーサポートは提供していません。サポートチャネルを利用するには、Logto Cloud でデプロイしてください。ご了承ください。

アカウント作成

Logto のホスティングが完了したら、ウェルカムページで「アカウント作成」をクリックしてください。ウェルカムページでは初回起動時のみ 1 アカウントの作成が可能で、アカウント作成はユーザー名とパスワードの組み合わせに限定されています。

ヒント:

デフォルトでは、Logto OSS（セルフホスト）では複数管理者の設定はサポートされていません。Console にメンバーを招待するには、セルフホストライセンス をインストールし、テナント設定 > メンバー で管理してください。あるいは、Logto Cloud ではチーム管理機能がすべて利用できます。

関連リソース

ローカル HTTPS 開発への対応

Logto コミュニティによるおすすめリソース