Comece com OSS

GitPod

Para iniciar um espaço de trabalho online do GitPod para o Logto, clique aqui. Aguarde alguns momentos, você verá a mensagem como:

Gitpod está em execução

O Logto usa a porta 3001 para seu serviço principal e a porta 3002 para o Console Administrativo 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
Docker
npm-init

O Docker Compose CLI 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:

Passo 1

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

logto db seed

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 administrativo, 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 endpoint do Logto se estiver usando um domínio personalizado
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Opcional) Substitua pela URL do admin do Logto se estiver usando um domínio personalizado
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Substitua pelo DSN do seu 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:

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.

Download e início

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:

O aplicativo principal está em execução em http://localhost:3001
O aplicativo principal está em execução em https://your-domain-url
O aplicativo administrativo está em execução em http://localhost:3002
O aplicativo administrativo está em execução em https://your-admin-domain-url

Vá para http://localhost:3002/ para continuar sua jornada com o 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

Note que o extra -- é necessário para o NPM passar os argumentos.

Configuração (opcional)

O 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.

Criar uma conta

Depois de hospedar 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.

GitPod​

Local​