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 を使用してください。
• ホスト IP を参照するには、DB_URL で 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 ^18.12.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 をサーバーに正常にホストしたら、ウェルカムページで「アカウント作成」をクリックしてください。オープンソース版 Logto では、初回起動時に 1 アカウントのみ作成可能で、複数アカウントには対応していません。アカウント作成はユーザー名とパスワードの組み合わせのみとなります。

ヒント:

Logto OSS（セルフホスト）は複数管理者の設定に対応していません。チームでの共同作業や複数管理ユーザーが必要なプロジェクトには、チーム管理機能が充実した Logto Cloud の利用を推奨します。

関連リソース

ローカル HTTPS 開発への対応

Logto コミュニティによる素晴らしいリソース集