Aller au contenu principal

Démarrage rapide : exécuter GeoLens localement en 10 minutes

Suivez ces étapes pour passer de git clone à une instance GeoLens pleinement opérationnelle avec accès administrateur et votre premier dataset téléversé. Aucun compte cloud requis - tout s’exécute localement avec Docker Compose.

Prérequis

  • ✓ Docker Compose v2 - fourni avec Docker Desktop 4.1+ ou comme plugin autonome
  • ✓ Ports locaux ouverts : - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)

Étape 1 : obtenir le code

Voie la plus rapide — cloner et installer en une commande :

curl -fsSL https://getgeolens.com/install.sh | sh

Ou récupérez le code manuellement — clonez le dépôt GeoLens ou téléchargez le tarball de la dernière version.

git clone https://github.com/geolens-io/geolens.git
cd geolens

Ou téléchargez le tarball de la version : github.com/geolens-io/geolens/releases/latest

Étape 2 : exécuter l’installeur

scripts/install.sh copie .env.example vers .env, génère un secret de signature JWT et demande un nom d’utilisateur administrateur (par défaut : admin) et un mot de passe. Laissez le mot de passe vide pour qu’un mot de passe robuste soit généré pour vous — récupérez-le ensuite avec grep '^GEOLENS_ADMIN_PASSWORD=' .env. Il exécute ensuite docker compose up -d. Le relancer est idempotent : les valeurs existantes sont préservées. Le premier build télécharge les images de base Postgres + PostGIS (~1 Go) et prend 5-10 minutes ; les démarrages suivants sont presque instantanés.

bash scripts/install.sh
À changer en production : Au-delà d’une évaluation locale, définissez un GEOLENS_ADMIN_PASSWORD robuste à l’invite (ou pré-définissez GEOLENS_ADMIN_USERNAME et GEOLENS_ADMIN_PASSWORD dans l’environnement pour une installation non interactive) et changez POSTGRES_PASSWORD dans .env.

Étape 3 : vérifier les services

Confirmez que tous les services du profil par défaut sont sains avant de vous connecter :

docker compose ps

Les services db, api, worker, titiler et frontend doivent tous afficher l’état running / healthy.

Étape 4 : se connecter et vérifier

Ouvrez l’interface GeoLens dans votre navigateur :

http://localhost:8080

Connectez-vous avec le nom d’utilisateur administrateur (par défaut : admin) et le mot de passe que vous avez défini ou que l’installeur a généré :

  • Nom d’utilisateur : admin
  • Mot de passe : le mot de passe défini ou celui généré

Le catalogue sera vide après une nouvelle installation - c’est normal. Téléversez votre premier dataset à l’étape suivante.

Étape 5 : téléverser votre premier dataset

Téléchargez un petit échantillon du domaine public - le shapefile Natural Earth 1:110m countries - puis téléversez-le via l’interface GeoLens. 

curl -LO https://naturalearth.s3.amazonaws.com/110m_cultural/ne_110m_admin_0_countries.zip

Dans l’interface GeoLens, cliquez sur le bouton de téléversement dans l’en-tête du catalogue, sélectionnez le fichier ZIP et confirmez le CRS détecté (EPSG:4326). Cliquez sur Commit pour publier. Le dataset apparaîtra dans le catalogue et sera disponible via OGC API à http://localhost:8080/api/collections.

Ce que vous verrez

Après l’étape 5, le dataset que vous avez importé apparaît dans le catalogue GeoLens. À mesure que vous ajoutez des données, le catalogue se remplit comme celui ci-dessous : des cartes de datasets avec recherche, badges de type et filtres à facettes. L’aperçu cartographique, le panneau de métadonnées et les endpoints OGC API à http://localhost:8080/api/collections sont actifs. Utilisez la barre de recherche pour filtrer les datasets, ouvrez une carte pour les métadonnées et lancez le constructeur de cartes pour composer des cartes multicouches.

Dépannage

  • Conflit de port - Si le port 5434, 8001 ou 8080 est déjà utilisé par un autre service, modifiez .env et changez DB_PORT, API_PORT ou FRONTEND_PORT vers des valeurs libres. Ensuite lancez docker compose down && docker compose up -d --build pour appliquer.
  • Échec de connexion admin - Confirmez que GEOLENS_ADMIN_USERNAME et GEOLENS_ADMIN_PASSWORD dans .env correspondent à ce que vous saisissez. Après modification de .env, redémarrez les services avec docker compose restart api.
  • Services lents à démarrer - Le premier docker compose up construit les images et télécharge ~1 Go de couches de base. Suivez la progression avec docker compose logs -f. Les démarrages suivants sont presque instantanés.
  • Échec de téléversement de fichier - Confirmez que le fichier fait partie des formats supportés : GeoJSON, Shapefile ZIP, GeoPackage, CSV ou URL publique de service OGC. Consultez la boîte de dialogue pour les erreurs de validation.

Étapes suivantes