Comienza con OSS

GitPod

Para iniciar un espacio de trabajo en línea de GitPod para Logto, haz clic aquí. Espera unos momentos, verás un mensaje como:

Gitpod está en funcionamiento

Logto utiliza el puerto 3001 para su servicio principal y el puerto 3002 para la Consola de Administración interactiva por defecto.

Para continuar tu viaje con Logto, presiona Ctrl (o Cmd) y haz clic en el enlace que comienza con https://3002-.... ¡Disfruta!

Local

Los requisitos mínimos recomendados de hardware para alojar Logto son:

vCPU: 2
Memoria: 8 GiB
Disco: 256 GiB

Docker Compose
Docker
npm-init

Docker Compose CLI generalmente viene con Docker Desktop.

precaución

¡No uses nuestro comando de docker compose para producción! Dado que actualmente tenemos una base de datos Postgres integrada junto con la aplicación Logto en docker-compose.yml, cada vez que vuelvas a ejecutar el comando se creará una nueva instancia de base de datos, y cualquier dato persistido anteriormente se perderá.

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

Después de una composición exitosa, verás un mensaje como:

Paso 1

Prepara una instancia de PostgreSQL@^14.0, y usa Logto CLI para sembrar una base de datos para Logto:

logto db seed

npx @logto/cli db seed

Paso 2

Descarga la imagen:

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

Paso 3

Mapea los puertos del contenedor al núcleo de Logto y la aplicación de administración, por ejemplo, 3001:3001 y 3002:3002; y establece las siguientes variables de entorno en el contenedor:

TRUST_PROXY_HEADER: 1 # Establecer en 1 si tienes un proxy HTTPS (por ejemplo, Nginx) frente a Logto
ENDPOINT: https://<your-logto-domain> # (Opcional) Reemplaza con tu URL de endpoint de Logto si estás usando un dominio personalizado
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Opcional) Reemplaza con tu URL de administración de Logto si estás usando un dominio personalizado
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Reemplaza con tu DSN de Postgres

Ejecuta el contenedor con todas las variables de entorno anteriores:

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

tip

Si estás usando Docker Hub, usa svhd/logto:latest en lugar de ghcr.io/logto-io/logto:latest.
Usa host.docker.internal o 172.17.0.1 en DB_URL para referirte a la IP del host.

Finalmente, verás un mensaje como:

Requisitos previos

Node.js ^18.12.0
PostgreSQL ^14.0

Versiones superiores generalmente funcionan pero no están garantizadas.

Recomendamos usar una nueva base de datos vacía dedicada a Logto, aunque no es un requisito estricto.

Descargar e iniciar

En tu terminal:

npm init @logto@latest

Una vez que completes el proceso de inicio e inicies Logto, verás un mensaje como:

La aplicación principal se está ejecutando en http://localhost:3001
La aplicación principal se está ejecutando en https://your-domain-url
La aplicación de administración se está ejecutando en http://localhost:3002
La aplicación de administración se está ejecutando en https://your-admin-domain-url

Dirígete a http://localhost:3002/ para continuar tu viaje con Logto. ¡Disfruta!

Usando una URL alternativa para descargar

Si deseas especificar una URL para el archivo zip de Logto, usa la opción --download-url. Por ejemplo:

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

Ten en cuenta que se necesita el -- extra para que NPM pase los argumentos.

Configuración (opcional)

Logto utiliza variables de entorno para la configuración, junto con soporte para archivos .env. Consulta Configuración para un uso detallado y la lista completa de variables.

Consulta Servicio principal si deseas controles más avanzados o acceso programático a Logto.

Crear una cuenta

Una vez que hayas alojado Logto con éxito en tu servidor, haz clic en "Crear cuenta" en la página de bienvenida. Ten en cuenta que la versión de código abierto de Logto solo permite la creación de una cuenta durante el lanzamiento inicial y no admite múltiples cuentas. El proceso de creación de cuentas se limita a combinaciones de nombre de usuario y contraseña.

GitPod​

Local​