Schnellstart: GeoLens lokal installieren
Folgen Sie diesen Schritten von curl -fsSL https://getgeolens.com/install.sh | sh bis zu einer vollständig funktionsfähigen GeoLens-Instanz mit Admin-Zugriff und Ihrem ersten hochgeladenen Dataset. Keine Cloud-Konten erforderlich - alles läuft lokal mit Docker Compose.
Die meisten Installationen laufen nach wenigen Minuten; ein Build aus dem Quellcode dauert 5 bis 10 Minuten.
Noch nicht bereit für Docker? Installation überspringen und die Live-Demo ansehen
Voraussetzungen
- ✓ Git und curl - der Installer klont das Repository und lädt über HTTPS herunter
- ✓ Docker Engine 24.0+ - über Docker Desktop oder die Docker-Engine-Pakete
- ✓ Docker Compose v2.20+ - in aktuellen Docker-Desktop-Versionen enthalten, sonst das Compose-Plugin separat installieren
- ✓ Arbeitsspeicher: - 8 GB oder mehr für Docker verfügbar - der Installer warnt unterhalb von 7 GB
- ✓ Offene lokale Ports: - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)
Schritt 1: Öffentlichen Installer ausführen
Empfohlene erste Ausführung:
curl -fsSL https://getgeolens.com/install.sh | sh Der Installer klont in ein Verzeichnis geolens. Führen Sie die übrigen Befehle dieser Seite darin aus:
cd geolens Lieber ein Source-Checkout oder das Tarball eines Releases? Klonen Sie das Repository und führen Sie darin bash scripts/install.sh aus. Installation aus dem Quellcode (öffnet neuen Tab)
Schritt 2: Anmelden
Öffnen Sie die GeoLens-Oberfläche im Browser:
http://localhost:8080 Melden Sie sich mit dem Admin-Benutzernamen (Standard: admin) und dem Passwort an, das Sie festgelegt haben oder das der Installer generiert hat:
- Benutzername:
admin - Passwort: das festgelegte oder generierte Passwort
Um ein generiertes Passwort anzuzeigen, führen Sie im Verzeichnis geolens Folgendes aus:
grep '^GEOLENS_ADMIN_PASSWORD=' .env Der Installer wartet, bis alle Dienste fehlerfrei laufen. Zum Selbstprüfen führen Sie docker compose ps aus.
Mehr als ein lokaler Test? Wählen Sie bei der Abfrage des Installers ein starkes Admin-Passwort und lesen Sie dann den Leitfaden zum Cloud-Deployment (öffnet neuen Tab).
Der Katalog ist nach einer frischen Installation leer - das ist erwartet. Laden Sie im nächsten Schritt Ihr erstes Dataset hoch.
Schritt 3: Erstes Dataset hochladen
Laden Sie ein kleines Public-Domain-Beispiel herunter - Natural Earth 1:110m countries Shapefile - und laden Sie es über die GeoLens-Oberfläche hoch.
curl -LO https://naturalearth.s3.amazonaws.com/110m_cultural/ne_110m_admin_0_countries.zip Klicken Sie in der GeoLens-Oberfläche auf Erstellen im Header, wählen Sie Daten importieren und dann die ZIP-Datei. GeoLens erkennt CRS (EPSG:4326) und Schema; bestätigen Sie den Import zum Veröffentlichen. Das Dataset erscheint in der Katalogsuche. Importe sind standardmäßig privat, daher listet die OGC API unter http://localhost:8080/api/collections es nur bei authentifizierten Anfragen (mit Bearer-Token) oder nachdem Sie das Dataset öffentlich gemacht haben. Das Öffnen dieser Adresse im Browser ist eine anonyme Anfrage und zeigt nur die Katalog-Sammlung.
Das Natural-Earth-Beispiel enthält die Antarktis, daher beschneidet der Import zwei Features an der Web-Mercator-Grenze, und die Dataset-Seite zeigt eine Warnung zu den Quellkoordinaten. Bei diesem Beispiel ist die Warnung erwartet.
Was Sie sehen werden
Nach Schritt 3 erscheint das hochgeladene Dataset im GeoLens-Katalog. Während Sie weitere Daten hinzufügen, füllt sich der Katalog wie der unten gezeigte: durchsuchbare Dataset-Karten mit Typ-Badges und facettierten Filtern. Kartenvorschau, Metadaten-Panel und OGC-API-Endpunkte unter http://localhost:8080/api/collections sind aktiv; private Datasets erscheinen dort nur bei authentifizierten Anfragen. Nutzen Sie die Suchleiste zum Filtern von Datasets, öffnen Sie eine Karte für Metadaten und starten Sie den Map Builder, um mehrschichtige Karten zu erstellen.
Schritt 4 (optional): Showcase-Karten laden
Lieber ein voller Katalog statt eines einzelnen Datasets? Das Repository enthält ein Seed-Skript, das sieben Showcase-Karten aus offenen Daten aufbaut, darunter die 3D-Skyline von Manhattan von der Startseite, dazu eine veröffentlichte Story und eine Dashboard-Karte. Aus dem geolens-Verzeichnis, das der Installer angelegt hat:
pip install httpx
python scripts/seed-showcase.py --username admin --password "$(grep '^GEOLENS_ADMIN_PASSWORD=' .env | cut -d= -f2-)" Benötigt Internetzugriff auf die offenen Datenquellen.
Fehlerbehebung
- Portkonflikt - Setzen Sie DB_PORT, API_PORT oder FRONTEND_PORT in .env auf freie Ports und starten Sie den Stack neu. Portkonflikte (öffnet neuen Tab)
- Admin-Login schlägt fehl - Führen Sie grep '^GEOLENS_ADMIN' .env aus, um die Zugangsdaten zu sehen. Das Konto wird beim ersten Start angelegt, spätere Änderungen an .env wirken sich daher nicht aus; ein anderer Admin kann das Passwort zurücksetzen. Passwort zurücksetzen (öffnet neuen Tab)
- Dienste starten langsam - Source-Checkouts bauen die Images lokal und brauchen länger als Release-Installationen. Den Fortschritt verfolgen Sie mit docker compose logs -f. Dienste starten nicht (öffnet neuen Tab)
- Dateiupload schlägt fehl - Prüfen Sie, ob die Datei eines der Formate hat, die die Seite Daten importieren auflistet, und lesen Sie die Validierungsfehler im Upload-Dialog. Unterstützte Formate (öffnet neuen Tab)
Nächste Schritte
- Ihre erste Karte erstellen (öffnet neuen Tab)
- QGIS mit GeoLens verbinden (öffnet neuen Tab)
- Team einladen und Rollen vergeben (öffnet neuen Tab)
- Instanz konfigurieren (öffnet neuen Tab)
- GeoLens aktualisieren (öffnet neuen Tab)
- Sichern und wiederherstellen (öffnet neuen Tab)
- Quellcode ansehen und beitragen auf GitHub