Primeiros passos com OSS

GitPod

Para iniciar um workspace online do GitPod para Logto, clique aqui. Aguarde alguns instantes e você verá uma mensagem como:

O Logto utiliza a porta 3001 para seu serviço principal e a porta 3002 para o Admin Console interativo por padrão.

Para continuar sua jornada com o Logto, pressione Ctrl (ou Cmd) e clique no link que começa com https://3002-.... Aproveite!

Local

Os requisitos mínimos recomendados de hardware para hospedar o Logto são:

• vCPU: 2
• Memória: 8 GiB
• Disco: 256 GiB

Docker Compose

O CLI do Docker Compose geralmente vem com o Docker Desktop.

cuidado:

Não utilize nosso comando docker compose em produção! Como atualmente temos um banco de dados Postgres embutido junto com o app Logto no docker-compose.yml, toda vez que você reexecutar o comando, uma nova instância do banco de dados será criada e todos os dados persistidos anteriormente serão perdidos.

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

Após uma composição bem-sucedida, você verá uma mensagem como:

Docker

Passo 1

Prepare uma instância do PostgreSQL@^14.0 e utilize o Logto CLI para semear um banco de dados para o Logto:

CLI

logto db seed

npx

npx @logto/cli db seed

Passo 2

Baixe a imagem:

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

Passo 3

Mapeie as portas do container para o core do Logto e o app admin, por exemplo, 3001:3001 e 3002:3002; e defina as seguintes variáveis de ambiente no container:

TRUST_PROXY_HEADER: 1 # Defina como 1 se você tiver um proxy HTTPS (ex: Nginx) na frente do Logto
ENDPOINT: https://<your-logto-domain> # (Opcional) Substitua pela URL do endpoint do Logto se estiver usando domínio personalizado
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Opcional) Substitua pela URL admin do Logto se estiver usando domínio personalizado
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Substitua pelo DSN do seu Postgres
DATABASE_STATEMENT_TIMEOUT: DISABLE_TIMEOUT # (v1.36.0+) Desabilite statement_timeout para PgBouncer/RDS Proxy

Execute o container com as variáveis de ambiente obrigatórias acima (as opcionais estão omitidas abaixo; adicione conforme necessário):

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

dica:

• Se estiver usando o Docker Hub, utilize svhd/logto:latest em vez de ghcr.io/logto-io/logto:latest.
• Use host.docker.internal ou 172.17.0.1 em DB_URL para se referir ao IP do host.
• Se estiver usando PgBouncer ou RDS Proxy e ver unsupported startup parameter: statement_timeout, defina DATABASE_STATEMENT_TIMEOUT=DISABLE_TIMEOUT (v1.36.0+).

Por fim, você verá uma mensagem como:

npm-init

Pré-requisitos

• Node.js ^18.12.0
• PostgreSQL ^14.0

Versões superiores geralmente funcionam, mas não são garantidas.

Recomendamos utilizar um novo banco de dados vazio dedicado ao Logto, embora não seja um requisito obrigatório.

Baixe e inicie

No seu terminal:

npm init @logto@latest

Assim que você concluir o processo de inicialização e iniciar o Logto, verá uma mensagem como:

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

Acesse http://localhost:3002/ para continuar sua jornada com o Logto. Aproveite!

Usando uma URL alternativa para download

Se você deseja especificar uma URL para o arquivo zip do Logto, utilize a opção --download-url. Por exemplo:

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

Observe que o -- extra é necessário para o NPM repassar os argumentos.

Configuração (opcional)

O Logto utiliza variáveis de ambiente para configuração, além do suporte ao arquivo .env. Veja Configuração para uso detalhado e lista completa de variáveis.

Confira Core service se você deseja controles mais avançados ou acesso programático ao Logto.

Provedores de hospedagem

Esses provedores de hospedagem confiáveis oferecem templates de instalação com um clique para o Logto. Com serviços facilmente implantáveis, você pode configurar e lançar seu sistema CIAM usando o Logto em segundos.

Logto Cloud

Um serviço em nuvem econômico com tenants de desenvolvimento gratuitos para fácil integração de autenticação.

Coolify

Uma alternativa auto-hospedável ao Heroku/Netlify para fácil gerenciamento de apps e banco de dados.

Dokploy

Ferramenta leve para implantar apps em sua própria infraestrutura.

Easypanel

Um painel de controle moderno para gerenciar servidores em nuvem com Docker.

Elestio

Plataforma DevOps totalmente gerenciada para implantar seu código e softwares open-source.

Railway

Simplifica a implantação de apps e o gerenciamento de infraestrutura.

Zeabur

Simplifica a implantação, escalonamento e monitoramento de apps para desenvolvedores.

Por favor, note que não fornecemos suporte ao cliente para provedores de serviços de terceiros. Para acessar nossos canais de suporte, faça a implantação no Logto Cloud. Obrigado!

Criar uma conta

Assim que você hospedar o Logto com sucesso em seu servidor, clique em "Criar conta" na página de boas-vindas. Lembre-se de que a versão open-source do Logto permite apenas a criação de uma conta durante o lançamento inicial e não suporta múltiplas contas. O processo de criação de conta é limitado à combinação de nome de usuário e senha.

dica:

O Logto OSS (auto-hospedado) não suporta a configuração de múltiplos administradores. Para colaboração em equipe e projetos que exigem múltiplos usuários admin, recomendamos o uso do Logto Cloud, que oferece recursos completos de gerenciamento de equipes.

Recursos relacionados

Lidando com desenvolvimento HTTPS local

Recursos incríveis da comunidade Logto