开始使用 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 命令！由于我们目前将内置的 Postgres 数据库与 Logto 应用程序一起打包在 docker-compose.yml 中，
每次你重新执行该命令时都会创建一个新的数据库实例，之前持久化的数据将会丢失。
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
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中使用host.docker.internal或172.17.0.1可指向主机 IP。 - 如果你使用 PgBouncer 或 RDS Proxy 并看到
unsupported startup parameter: statement_timeout，请设置DATABASE_STATEMENT_TIMEOUT=DISABLE_TIMEOUT（v1.36.0+）。
最后，你会看到类似如下的信息：
前置条件
- 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，请查看 核心服务。
托管服务商
这些可靠的托管服务商为 Logto 提供了一键安装模板。通过便捷的部署服务，你可以在几秒钟内使用 Logto 搭建并启动你的 CIAM 系统。
经济高效的云服务，提供免费的开发租户，便于集成认证 (Authentication)。
一个可自托管的 Heroku/Netlify 替代方案，便于应用和数据库管理。
轻量级工具，可在你自己的基础设施上部署应用。
现代化控制面板，支持使用 Docker 管理云服务器。
全托管 DevOps 平台，支持部署你的代码和开源软件。
简化应用部署和基础设施管理。
为开发者简化应用部署、扩展和监控。
请注意，我们不为第三方服务商提供客户支持。如需访问我们的支持渠道，请在 Logto Cloud 上部署。谢谢！
创建账户
当你成功在服务器上部署 Logto 后，请在欢迎页面点击“创建账户”。请注意，欢迎页面仅在首次启动时允许创建一个账户，且账户创建流程仅支持用户名和密码组合。
默认情况下，Logto OSS（自托管）不支持配置多个管理员。如需邀请更多成员加入控制台，请安装 自托管许可证 并在 租户设置 > 成员 中管理成员。或者，Logto Cloud 提供完整的团队管理功能。