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
  • ✓ ~4 GB freier RAM - für Postgres, PostGIS, die API und den Frontend-Container
  • ✓ ~10 GB Speicherplatz - für die Postgres- und PostGIS-Basisimages, die beim ersten Build heruntergeladen werden
  • ✓ Offene lokale Ports: - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)

Schritt 1: Code holen

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:

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

Schritt 2: Umgebung konfigurieren

Kopieren Sie die Beispiel-.env-Datei. Die Standardwerte funktionieren lokal direkt - Änderungen sind nur nötig, wenn Sie Admin-Benutzername oder Passwort ändern möchten.

cp .env.example .env
In Produktion ändern: Drei Variablen in .env.example sind für eine Änderung in Produktion markiert: POSTGRES_PASSWORD, JWT_SECRET_KEY und GEOLENS_ADMIN_PASSWORD. Für lokale Evaluierung können Sie sie unverändert lassen.

Schritt 3: Dienste starten

docker compose up -d --build

Der erste Build lädt Postgres- und PostGIS-Basisimages (~1 GB) herunter. Spätere Starts dauern weniger als 10 Sekunden. Prüfen Sie, ob alle Dienste laufen:

docker compose ps

Die Dienste api, db und frontend sollten alle den Status running zeigen.

Schritt 4: Anmelden und prüfen

Öffnen Sie die GeoLens-Oberfläche im Browser:

http://localhost:8080

Melden Sie sich mit den Standard-Zugangsdaten aus .env.example an:

  • Benutzername: admin
  • Passwort: admin

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

Was Sie sehen werden

Nach Schritt 5 zeigt Ihr Browser den GeoLens-Katalog mit Ihrem ersten Dataset. Kartenvorschau, Metadaten-Panel und OGC-API-Endpunkte unter http://localhost:8001/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