Comece com OSS

GitPod

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

Logto usa a porta 3001 para seu serviço principal e a porta 3002 para o Console de Administração interativo por padrão.

Para continuar sua jornada com 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 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 use nosso comando docker compose para produção! Como atualmente temos um banco de dados Postgres embutido junto com o aplicativo Logto em docker-compose.yml, toda vez que você reexecutar o comando, uma nova instância do banco de dados será criada, e qualquer dado persistido anteriormente será perdido.

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á a mensagem como:

Docker

Passo 1

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

CLI

logto db seed

npx

npx @logto/cli db seed

Passo 2

Puxe a imagem:

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

Passo 3

Mapeie as portas do contêiner para o núcleo do Logto e o aplicativo de administração, por exemplo, 3001:3001 e 3002:3002; e defina as seguintes variáveis de ambiente para o contêiner:

TRUST_PROXY_HEADER: 1 # Defina como 1 se você tiver um proxy HTTPS (por exemplo, Nginx) na frente do Logto
ENDPOINT: https://<your-logto-domain> # (Opcional) Substitua pela URL do seu endpoint Logto se estiver usando um domínio personalizado
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Opcional) Substitua pela URL do seu admin Logto se estiver usando um domínio personalizado
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Substitua pelo seu DSN do Postgres

Execute o contêiner com todas as variáveis de ambiente acima:

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 você estiver usando o Docker Hub, use 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.

Finalmente, você verá a 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 usar um novo banco de dados vazio dedicado ao Logto, embora não seja um requisito rígido.

Baixar e iniciar

No seu terminal:

npm init @logto@latest

Uma vez que você complete o processo de inicialização e inicie o Logto, você verá a 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

Vá para http://localhost:3002/ para continuar sua jornada com Logto. Aproveite!

Usando uma URL alternativa para download

Se você quiser especificar uma URL para o arquivo zip do Logto, use 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 passar os argumentos.

Configuração (opcional)

Logto usa variáveis de ambiente para configuração, juntamente com suporte a arquivos .env. Veja Configuração para uso detalhado e lista completa de variáveis.

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

Provedores de hospedagem

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

Logto Cloud

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

Coolify

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

Dokploy

Ferramenta leve para implantar aplicativos 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 software open-source.

Railway

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

Zeabur

Simplifica a implantação, escalonamento e monitoramento de aplicativos 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, gentilmente faça a implantação no Logto Cloud. Obrigado!

Criar uma conta

Uma vez que você tenha hospedado com sucesso o Logto 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 a combinações de nome de usuário e senha.

Recursos relacionados

Lidando com desenvolvimento HTTPS local