Démarrage rapide : installer GeoLens localement
Suivez ces étapes pour passer de curl -fsSL https://getgeolens.com/install.sh | sh à 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.
La plupart des installations tournent en quelques minutes ; une compilation depuis les sources prend de 5 à 10 minutes.
Pas encore prêt à lancer Docker ? Sautez l'installation et explorez la démo en ligne
Prérequis
- ✓ Git et curl - l'installeur clone le dépôt et télécharge via HTTPS
- ✓ Docker Engine 24.0+ - via Docker Desktop ou les paquets Docker Engine
- ✓ Docker Compose v2.20+ - fourni avec les versions actuelles de Docker Desktop, ou installez le plugin compose séparément
- ✓ Mémoire : - 8 Go ou plus disponibles pour Docker : l'installeur avertit en dessous de 7 Go
- ✓ Ports locaux ouverts : - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)
Étape 1 : lancer l'installeur public
Première exécution recommandée :
curl -fsSL https://getgeolens.com/install.sh | sh L'installeur clone dans un répertoire geolens. Lancez les autres commandes de cette page depuis ce répertoire :
cd geolens Vous préférez un checkout des sources ou l'archive d'une version ? Clonez le dépôt et lancez bash scripts/install.sh depuis celui-ci. Installer depuis les sources (ouvre un nouvel onglet)
Étape 2 : se connecter
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é
Pour afficher un mot de passe généré, lancez ceci depuis le répertoire geolens :
grep '^GEOLENS_ADMIN_PASSWORD=' .env L'installeur attend que tous les services soient opérationnels. Pour les vérifier vous-même, lancez docker compose ps.
Vous allez au-delà d'un essai local ? Choisissez un mot de passe administrateur robuste à l'invite de l'installeur, puis lisez le guide de déploiement cloud (ouvre un nouvel onglet).
Le catalogue sera vide après une nouvelle installation - c'est normal. Téléversez votre premier dataset à l'étape suivante.
Étape 3 : 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 Créer dans l'en-tête, choisissez Importer des données et sélectionnez le fichier ZIP. GeoLens détecte le CRS (EPSG:4326) et le schéma ; confirmez l'import pour publier. Le dataset apparaît dans la recherche du catalogue. Les imports sont privés par défaut, donc l'OGC API à http://localhost:8080/api/collections ne le liste que pour les requêtes authentifiées (envoyez un jeton porteur) ou une fois le dataset rendu public. Ouvrir cette adresse dans le navigateur est une requête anonyme : elle n'affiche que la collection du catalogue.
L'échantillon Natural Earth contient l'Antarctique : l'import écrête donc deux entités à la limite de Web Mercator, et la page du dataset affiche un avertissement sur les coordonnées de la source. Pour cet échantillon, l'avertissement est normal.
Ce que vous verrez
Après l'étape 3, 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 ; les datasets privés n'y apparaissent que pour les requêtes authentifiées. 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.
Étape 4 (facultative) : charger les cartes de démonstration
Envie d'un catalogue complet plutôt que d'un seul dataset ? Le dépôt inclut un script qui construit sept cartes de démonstration à partir de données ouvertes publiques, dont la skyline 3D de Manhattan de la page d'accueil, ainsi qu'un récit publié et une carte avec tableau de bord. Depuis le répertoire geolens créé par l'installeur :
pip install httpx
python scripts/seed-showcase.py --username admin --password "$(grep '^GEOLENS_ADMIN_PASSWORD=' .env | cut -d= -f2-)" Nécessite un accès internet aux sources de données ouvertes.
Dépannage
- Conflit de port - Changez DB_PORT, API_PORT ou FRONTEND_PORT dans .env pour des ports libres, puis redémarrez la pile. Conflits de ports (ouvre un nouvel onglet)
- Échec de connexion admin - Lancez grep '^GEOLENS_ADMIN' .env pour voir les identifiants. Le compte est créé au premier démarrage, donc modifier .env ensuite ne le change pas ; un autre administrateur peut réinitialiser le mot de passe. Réinitialiser un mot de passe (ouvre un nouvel onglet)
- Services lents à démarrer - Les checkouts des sources compilent les images localement et prennent plus de temps que les installations d'une version. Suivez la progression avec docker compose logs -f. Services qui ne démarrent pas (ouvre un nouvel onglet)
- Échec de téléversement de fichier - Vérifiez que le fichier est dans un des formats listés par la page Importer des données, et lisez les erreurs de validation dans la boîte de dialogue de téléversement. Formats pris en charge (ouvre un nouvel onglet)
Étapes suivantes
- Créer votre première carte (ouvre un nouvel onglet)
- Connecter QGIS à GeoLens (ouvre un nouvel onglet)
- Inviter votre équipe et attribuer les rôles (ouvre un nouvel onglet)
- Configurer l'instance (ouvre un nouvel onglet)
- Mettre à jour GeoLens (ouvre un nouvel onglet)
- Sauvegarder et restaurer (ouvre un nouvel onglet)
- Consultez le code source et contribuez sur GitHub