Commencer avec OSS

GitPod

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

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 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 le message suivant :

Docker

Étape 1

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

CLI

logto db seed

npx

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

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 le message suivant :

npm-init

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 cela 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 le message suivant :

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 prise en charge des fichiers .env. Voir Configuration pour une utilisation détaillée et la liste complète des variables.

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

Fournisseurs d'hébergement

Ces fournisseurs d'hébergement fiables offrent 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 en utilisant Logto en quelques secondes.

Logto Cloud

Un service cloud économique avec des locataires de développement gratuits pour une intégration facile de l'authentification.

Coolify

Une alternative auto-hébergeable à Heroku/Netlify pour une gestion facile des applications et des bases de données.

Dokploy

Outil léger pour déployer des applications sur votre propre infrastructure.

Easypanel

Un panneau de contrôle moderne pour gérer les serveurs cloud avec Docker.

Elestio

Plateforme DevOps entièrement gérée pour déployer votre code et logiciels open-source.

Railway

Simplifie le déploiement des applications et la gestion de l'infrastructure.

Zeabur

Simplifie le déploiement, la mise à l'échelle et la surveillance des applications pour les développeurs.

Veuillez noter que nous ne fournissons 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 est limité aux combinaisons de nom d'utilisateur et de mot de passe.

Ressources associées

Gérer le développement HTTPS local