Commencer avec OSS

GitPod

Pour démarrer un espace de travail GitPod en ligne pour Logto, cliquez ici. Attendez quelques instants, vous verrez un message comme :

Gitpod est en cours d'exécution

Logto utilise le port 3001 pour son service principal et le port 3002 pour la console d'administration interactive par défaut.

Pour continuer votre parcours avec Logto, appuyez sur Ctrl (ou Cmd) et cliquez sur le lien qui commence par https://3002-.... Profitez-en !

Local

Les exigences matérielles minimales recommandées pour héberger Logto sont :

vCPU : 2
Mémoire : 8 GiB
Disque : 256 GiB

Docker Compose
Docker
npm-init

Docker Compose CLI est généralement fourni avec Docker Desktop.

attention

N'utilisez pas notre commande docker compose pour la production ! Étant donné que nous avons actuellement une base de données Postgres intégrée avec l'application Logto dans docker-compose.yml, chaque fois que vous réexécutez la commande, une nouvelle instance de base de données sera créée, et toutes les données précédemment enregistrées seront perdues.

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

Après une composition réussie, vous verrez un message comme :

Étape 1

Préparez une instance PostgreSQL@^14.0, et utilisez Logto CLI pour initialiser une base de données pour Logto :

logto db seed

npx @logto/cli db seed

Étape 2

Récupérez l'image :

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

Étape 3

Mappez les ports du conteneur vers le noyau et l'application d'administration de Logto, par exemple, 3001:3001 et 3002:3002 ; et définissez les variables d'environnement suivantes pour le conteneur :

TRUST_PROXY_HEADER: 1 # Réglez sur 1 si vous avez un proxy HTTPS (par exemple, Nginx) devant Logto
ENDPOINT: https://<your-logto-domain> # (Optionnel) Remplacez par l'URL de votre point de terminaison Logto si vous utilisez un domaine personnalisé
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Optionnel) Remplacez par l'URL de votre administration Logto si vous utilisez un domaine personnalisé
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Remplacez par votre DSN Postgres

Exécutez le conteneur avec toutes les variables d'environnement ci-dessus :

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

astuce

Si vous utilisez Docker Hub, utilisez svhd/logto:latest au lieu de ghcr.io/logto-io/logto:latest.
Utilisez host.docker.internal ou 172.17.0.1 dans DB_URL pour faire référence à l'IP de l'hôte.

Enfin, vous verrez un message comme :

Prérequis

Node.js ^18.12.0
PostgreSQL ^14.0

Les versions supérieures fonctionnent généralement mais ne sont pas garanties.

Nous recommandons d'utiliser une nouvelle base de données vide dédiée à Logto, bien que ce ne soit pas une exigence stricte.

Télécharger et démarrer

Dans votre terminal :

npm init @logto@latest

Une fois que vous avez terminé le processus d'initialisation et démarré Logto, vous verrez un message comme :

L'application principale fonctionne sur http://localhost:3001
L'application principale fonctionne sur https://your-domain-url
L'application d'administration fonctionne sur http://localhost:3002
L'application d'administration fonctionne sur https://your-admin-domain-url

Rendez-vous sur http://localhost:3002/ pour continuer votre parcours avec Logto. Profitez-en !

Utiliser une URL alternative pour le téléchargement

Si vous souhaitez spécifier une URL pour le fichier zip de Logto, utilisez l'option --download-url. Par exemple :

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

Notez que le -- supplémentaire est nécessaire pour que NPM passe les arguments.

Configuration (optionnelle)

Logto utilise des variables d'environnement pour la configuration, avec la prise en charge du fichier .env. Voir Configuration pour une utilisation détaillée et la liste complète des variables.

Consultez Core service si vous souhaitez des contrôles plus avancés ou un accès programmatique à Logto.

Créer un compte

Une fois que vous avez hébergé avec succès Logto sur votre serveur, cliquez sur "Créer un compte" sur la page d'accueil. Gardez à l'esprit que la version open-source de Logto ne permet la création d'un seul compte lors du lancement initial et ne prend pas en charge plusieurs comptes. Le processus de création de compte est limité aux combinaisons de nom d'utilisateur et de mot de passe.

GitPod​

Local​