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 :
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.
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 :
- CLI
- npx
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 à Logto core et à l'application d'administration, 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 votre URL de point de terminaison Logto si vous utilisez un domaine personnalisé
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Optionnel) Remplacez par votre URL d'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
- Si vous utilisez Docker Hub, utilisez
svhd/logto:latest
au lieu deghcr.io/logto-io/logto:latest
. - Utilisez
host.docker.internal
ou172.17.0.1
dansDB_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 est en cours d'exécution à http://localhost:3001
L'application principale est en cours d'exécution à https://your-domain-url
L'application d'administration est en cours d'exécution à http://localhost:3002
L'application d'administration est en cours d'exécution à 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 des fichiers .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é Logto avec succès 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.