Commencer avec OSS
GitPod
Pour démarrer un espace de travail GitPod en ligne pour Logto, cliquez ici. Patientez quelques instants, vous verrez un message tel que :

Logto utilise par défaut le port 3001 pour son service principal et le port 3002 pour la Console d’administration interactive.
Pour poursuivre votre expérience 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
L’interface en ligne de commande Docker Compose est généralement incluse avec Docker Desktop.
N’utilisez pas notre commande docker compose en production ! Puisque nous avons actuellement une base de données Postgres intégrée avec l’application Logto dans docker-compose.yml,
à chaque nouvelle exécution de 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 tel que :
Étape 1
Préparez une instance PostgreSQL@^14.0, puis 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 vers Logto core et l’application admin, par exemple, 3001:3001 et 3002:3002 ; et définissez les variables d’environnement suivantes dans le conteneur :
TRUST_PROXY_HEADER: 1 # Mettez à 1 si vous avez un proxy HTTPS (ex. Nginx) devant Logto
ENDPOINT: https://<your-logto-domain> # (Optionnel) Remplacez par l’URL de votre endpoint Logto si vous utilisez un domaine personnalisé
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Optionnel) Remplacez par l’URL admin de Logto si vous utilisez un domaine personnalisé
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Remplacez par votre DSN Postgres
Lancez 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:latestau lieu deghcr.io/logto-io/logto:latest. - Utilisez
host.docker.internalou172.17.0.1dansDB_URLpour référencer l’IP de l’hôte.
Enfin, vous verrez un message tel que :
Prérequis
- Node.js
^18.12.0 - PostgreSQL
^14.0
Des 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 cela ne soit pas une obligation stricte.
Télécharger et démarrer
Dans votre terminal :
npm init @logto@latest
Une fois le processus d’initialisation terminé et Logto démarré, vous verrez un message tel que :
L’application principale fonctionne sur http://localhost:3001
L’application principale fonctionne sur https://your-domain-url
L’application admin fonctionne sur http://localhost:3002
L’application admin fonctionne sur https://your-admin-domain-url
Rendez-vous sur http://localhost:3002/ pour poursuivre votre expérience Logto. Profitez-en !
Utiliser une URL alternative pour le téléchargement
Si vous souhaitez spécifier une URL pour le fichier zip 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 transmette les arguments.
Configuration (optionnel)
Logto utilise des variables d’environnement pour la configuration, avec prise en charge du fichier .env. Voir Configuration pour l’utilisation détaillée et la liste complète des variables.
Consultez Service principal si vous souhaitez des contrôles avancés ou un accès programmatique à Logto.
Fournisseurs d’hébergement
Ces fournisseurs d’hébergement fiables proposent des modèles d’installation en un clic pour Logto. Avec des services facilement déployables, vous pouvez configurer et lancer votre système CIAM avec Logto en quelques secondes.
Un service cloud économique avec des locataires de développement gratuits pour une intégration facile de l’authentification.
Une alternative auto-hébergeable à Heroku/Netlify pour une gestion facile des applications et des bases de données.
Outil léger pour déployer des applications sur votre propre infrastructure.
Un panneau de contrôle moderne pour gérer les serveurs cloud avec Docker.
Plateforme DevOps entièrement gérée pour déployer votre code et vos logiciels open-source.
Simplifie le déploiement des applications et la gestion de l’infrastructure.
Simplifie le déploiement, la montée en charge et la surveillance des applications pour les développeurs.
Veuillez noter que nous n’assurons pas de support client pour les fournisseurs de services tiers. Pour accéder à nos canaux de support, veuillez déployer sur Logto Cloud. Merci !
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 que d’un seul compte lors du lancement initial et ne prend pas en charge plusieurs comptes. Le processus de création de compte se limite à une combinaison nom d’utilisateur et mot de passe.
Logto OSS (auto-hébergé) ne prend pas en charge la configuration de plusieurs administrateurs. Pour la collaboration en équipe et les projets nécessitant plusieurs utilisateurs admin, nous recommandons d’utiliser Logto Cloud, qui offre des fonctionnalités complètes de gestion d’équipe.