OSS を始める
GitPod
Logto のオンライン GitPod ワークスペースを開始するには、こちらをクリックしてください。しばらく待つと、次のようなメッセージが表示されます:
Logto はデフォルトで、コアサービスにポート 3001
、インタラクティブな管理コンソールにポート 3002
を使用します。
Logto の旅を続けるには、Ctrl (または Cmd) を押しながら https://3002-...
で始まるリンクをクリックしてください。お楽しみください!
ローカル
Logto をホストするための最小限の推奨ハードウェア要件は次のとおりです:
- vCPU: 2
- メモリ: 8 GiB
- ディスク: 256 GiB
- Docker Compose
- Docker
- npm-init
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
成功したコンポジションの後、次のようなメッセージが表示されます:
ステップ 1
PostgreSQL@^14.0 インスタンスを準備し、Logto CLI を使用して Logto 用のデータベースをシードします:
- CLI
- npx
logto db seed
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 に置き換え
上記のすべての環境変数を使用してコンテナを実行します:
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
を使用してください。
最後に、次のようなメッセージが表示されます:
前提条件
- 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 へのプログラム的アクセスを希望する場合は、コアサービス を確認してください。
アカウントを作成する
Logto をサーバーに正常にホストしたら、ウェルカムページで「アカウントを作成」をクリックしてください。Logto のオープンソースバージョンでは、初回起動時に 1 つのアカウント作成のみが許可されており、複数のアカウントはサポートされていません。アカウント作成プロセスは、ユーザー名とパスワードの組み合わせに限定されています。