Zum Hauptinhalt springen

Schnellstart: GeoLens lokal in 10 Minuten ausführen

Folgen Sie diesen Schritten von git clone 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.

Voraussetzungen

  • ✓ Docker Compose v2 - enthalten in Docker Desktop 4.1+ oder als eigenständiges Plugin
  • ✓ Offene lokale Ports: - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)

Schritt 1: Code holen

Schnellster Weg — klonen und in einem Befehl installieren:

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

Oder holen Sie den Code manuell — klonen Sie das GeoLens-Repository oder laden Sie das Tarball der neuesten Version herunter.

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

Oder laden Sie das Release-Tarball herunter: github.com/geolens-io/geolens/releases/latest

Schritt 2: Installer ausführen

scripts/install.sh kopiert .env.example nach .env, generiert ein JWT-Signing-Secret und fragt nach einem Admin-Benutzernamen (Standard: admin) und einem Passwort. Lassen Sie das Passwort leer, damit ein starkes für Sie generiert wird — rufen Sie es später mit grep '^GEOLENS_ADMIN_PASSWORD=' .env ab. Anschließend führt es docker compose up -d aus. Erneutes Ausführen ist idempotent — vorhandene Werte bleiben erhalten. Der erste Build lädt Postgres- und PostGIS-Basisimages (~1 GB) herunter und dauert 5-10 Minuten; spätere Starts sind nahezu sofort.

bash scripts/install.sh
In Produktion ändern: Über die lokale Evaluierung hinaus setzen Sie bei der Eingabeaufforderung ein starkes GEOLENS_ADMIN_PASSWORD (oder setzen Sie GEOLENS_ADMIN_USERNAME und GEOLENS_ADMIN_PASSWORD vorab als Umgebungsvariablen für unbeaufsichtigte Installationen) und rotieren Sie POSTGRES_PASSWORD in .env.

Schritt 3: Dienste prüfen

Stellen Sie sicher, dass alle Dienste des Standardprofils gesund sind, bevor Sie sich anmelden:

docker compose ps

Die Dienste db, api, worker, titiler und frontend sollten alle den Status running / healthy zeigen.

Schritt 4: Anmelden und prüfen

Ö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

Der Katalog ist nach einer frischen Installation leer - das ist erwartet. Laden Sie im nächsten Schritt Ihr erstes Dataset hoch.

Schritt 5: 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 den Upload-Button im Katalog-Header, wählen Sie die ZIP-Datei und bestätigen Sie das erkannte CRS (EPSG:4326). Klicken Sie auf Commit, um zu veröffentlichen. Das Dataset erscheint im Katalog und ist über die OGC API verfügbar unter http://localhost:8080/api/collections.

Was Sie sehen werden

Nach Schritt 5 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. 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.

Fehlerbehebung

  • Portkonflikt - Wenn Port 5434, 8001 oder 8080 bereits von einem anderen Dienst belegt ist, bearbeiten Sie .env und ändern Sie DB_PORT, API_PORT oder FRONTEND_PORT auf freie Werte. Führen Sie dann docker compose down && docker compose up -d --build aus.
  • Admin-Login schlägt fehl - Prüfen Sie, ob GEOLENS_ADMIN_USERNAME und GEOLENS_ADMIN_PASSWORD in .env mit Ihrer Eingabe übereinstimmen. Nach Änderungen an .env starten Sie die Dienste mit docker compose restart api neu.
  • Dienste starten langsam - Das erste docker compose up baut Images und lädt ~1 GB Basisschichten herunter. Beobachten Sie den Fortschritt mit docker compose logs -f. Spätere Starts sind nahezu sofort.
  • Dateiupload schlägt fehl - Prüfen Sie, ob die Datei eines der unterstützten Formate ist: GeoJSON, Shapefile ZIP, GeoPackage, CSV oder eine öffentliche OGC-Service-URL. Prüfen Sie den Upload-Dialog auf Validierungsfehler.

Nächste Schritte

  • Entdecken Sie den vollen Funktionsumfang auf der Funktionsseite
  • Quellcode ansehen und beitragen auf GitHub
  • Lesen Sie CONTRIBUTING.md für die Einrichtung der Entwicklungsumgebung