Comienza con OSS

GitPod

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

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 experiencia 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

La CLI de Docker Compose normalmente viene con Docker Desktop.

precaución:

¡No utilices nuestro comando de docker compose para producción! Ya que actualmente tenemos una base de datos Postgres incorporada junto con la app de Logto en docker-compose.yml, cada vez que vuelvas a ejecutar el comando se creará una nueva instancia de base de datos y se perderán todos los datos persistidos previamente.

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:

Docker

Paso 1

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

CLI

logto db seed

npx

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 app de administración, por ejemplo, 3001:3001 y 3002:3002; y establece las siguientes variables de entorno en el contenedor:

TRUST_PROXY_HEADER: 1 # Establece en 1 si tienes un proxy HTTPS (por ejemplo, Nginx) delante de Logto
ENDPOINT: https://<your-logto-domain> # (Opcional) Reemplaza con la URL de tu endpoint de Logto si usas un dominio personalizado
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Opcional) Reemplaza con la URL de administración de Logto si usas un dominio personalizado
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Reemplaza con tu DSN de Postgres
DATABASE_STATEMENT_TIMEOUT: DISABLE_TIMEOUT # (v1.36.0+) Desactiva statement_timeout para PgBouncer/RDS Proxy

Ejecuta el contenedor con las variables de entorno requeridas arriba (las opcionales se omiten abajo; agrégalas según sea necesario):

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 usas Docker Hub, utiliza 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.
• Si usas PgBouncer o RDS Proxy y ves unsupported startup parameter: statement_timeout, establece DATABASE_STATEMENT_TIMEOUT=DISABLE_TIMEOUT (v1.36.0+).

Finalmente, verás un mensaje como:

npm-init

Requisitos previos

• Node.js ^18.12.0
• PostgreSQL ^14.0

Las versiones superiores suelen funcionar pero no están garantizadas.

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

Descarga e inicia

En tu terminal:

npm init @logto@latest

Una vez completes el proceso de inicialización e inicies Logto, verás un mensaje como:

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

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

Usar una URL alternativa para la descarga

Si deseas especificar una URL para el archivo zip de Logto, utiliza 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 el uso detallado y la lista completa de variables.

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

Proveedores de alojamiento

Estos proveedores de alojamiento confiables ofrecen plantillas de instalación con un solo clic para Logto. Con servicios fácilmente desplegables, puedes configurar y lanzar tu sistema CIAM usando Logto en segundos.

Logto Cloud

Un servicio en la nube rentable con inquilinos de desarrollo gratuitos para una integración de autenticación sencilla.

Coolify

Una alternativa autoalojable a Heroku/Netlify para una gestión sencilla de aplicaciones y bases de datos.

Dokploy

Herramienta ligera para desplegar aplicaciones en tu propia infraestructura.

Easypanel

Un panel de control moderno para gestionar servidores en la nube con Docker.

Elestio

Plataforma DevOps totalmente gestionada para desplegar tu código y software de código abierto.

Railway

Simplifica el despliegue de aplicaciones y la gestión de infraestructura.

Zeabur

Simplifica el despliegue, escalado y monitoreo de aplicaciones para desarrolladores.

Ten en cuenta que no proporcionamos soporte al cliente para proveedores de servicios de terceros. Para acceder a nuestros canales de soporte, despliega en Logto Cloud. ¡Gracias!

Crear una cuenta

Una vez que hayas alojado Logto correctamente 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 cuenta está limitado a combinaciones de nombre de usuario y contraseña.

tip:

Logto OSS (autoalojado) no admite la configuración de múltiples administradores. Para colaboración en equipo y proyectos que requieran varios usuarios administradores, recomendamos usar Logto Cloud, que proporciona funciones completas de gestión de equipos.

Recursos relacionados

Cómo trabajar con desarrollo HTTPS local

Recursos increíbles de la comunidad Logto