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
  • ✓ ~4 Go de RAM libres - pour Postgres, PostGIS, l’API et le conteneur frontend
  • ✓ ~10 Go de disque - pour les images de base Postgres + PostGIS téléchargées au premier build
  • ✓ Ports locaux ouverts : - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)

Étape 1 : obtenir le code

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 :

curl -L https://github.com/geolens-io/geolens/archive/refs/heads/main.tar.gz -o geolens.tar.gz
tar -xzf geolens.tar.gz
cd geolens-main

Étape 2 : configurer l’environnement

Copiez le fichier .env d’exemple. Les valeurs par défaut fonctionnent pour le développement local - aucune modification requise sauf si vous voulez changer l’identifiant ou le mot de passe administrateur.

cp .env.example .env
À changer en production : Trois variables dans .env.example doivent être changées en production : POSTGRES_PASSWORD, JWT_SECRET_KEY et GEOLENS_ADMIN_PASSWORD. Pour une évaluation locale, vous pouvez les laisser telles quelles.

Étape 3 : démarrer les services

docker compose up -d --build

Le premier build télécharge les images de base Postgres + PostGIS (~1 Go). Les démarrages suivants prennent moins de 10 secondes. Vérifiez que tous les services fonctionnent :

docker compose ps

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

Étape 4 : se connecter et vérifier

Ouvrez l’interface GeoLens dans votre navigateur :

http://localhost:8080

Connectez-vous avec les identifiants par défaut de .env.example :

  • Nom d’utilisateur : admin
  • Mot de passe : admin

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:8001/collections.

Ce que vous verrez

Après l’étape 5, votre navigateur affiche le catalogue GeoLens avec votre premier dataset. L’aperçu cartographique, le panneau de métadonnées et les endpoints OGC API à http://localhost:8001/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