Saltar al contenido principal

Inicio rápido: ejecuta GeoLens localmente en 10 minutos

Sigue estos pasos para pasar de git clone a una instancia GeoLens completamente operativa con acceso de administrador y tu primer dataset cargado. No se requieren cuentas en la nube: todo se ejecuta localmente con Docker Compose.

Requisitos previos

  • ✓ Docker Compose v2 - incluido con Docker Desktop 4.1+ o como plugin independiente
  • ✓ Puertos locales abiertos: - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)

Paso 1: Obtener el código

Vía más rápida: clonar e instalar con un solo comando:

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

O consigue el código manualmente: clona el repositorio de GeoLens o descarga el tarball de la última versión.

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

O descarga el tarball de la versión: github.com/geolens-io/geolens/releases/latest

Paso 2: Ejecutar el instalador

scripts/install.sh copia .env.example a .env, genera un secreto de firma JWT y solicita un usuario administrador (predeterminado: admin) y una contraseña. Deja la contraseña en blanco para que se genere una fuerte por ti: recupérala después con grep '^GEOLENS_ADMIN_PASSWORD=' .env. Luego ejecuta docker compose up -d. Volver a ejecutarlo es idempotente: se conservan los valores existentes. La primera compilación descarga imágenes base de Postgres + PostGIS (~1 GB) y tarda 5-10 minutos; los inicios posteriores son casi instantáneos.

bash scripts/install.sh
Cambiar en producción: Más allá de la evaluación local, define un GEOLENS_ADMIN_PASSWORD fuerte cuando se solicite (o preestablece GEOLENS_ADMIN_USERNAME y GEOLENS_ADMIN_PASSWORD en el entorno para instalaciones desatendidas) y rota POSTGRES_PASSWORD en .env.

Paso 3: Verificar servicios

Confirma que todos los servicios del perfil predeterminado están sanos antes de iniciar sesión:

docker compose ps

Los servicios db, api, worker, titiler y frontend deben mostrar estado running / healthy.

Paso 4: Iniciar sesión y verificar

Abre la interfaz de GeoLens en tu navegador:

http://localhost:8080

Inicia sesión con el usuario administrador (predeterminado: admin) y la contraseña que configuraste o que generó el instalador:

  • Usuario: admin
  • Contraseña: la contraseña que configuraste o la generada

El catálogo estará vacío después de una instalación nueva; es lo esperado. Carga tu primer dataset en el siguiente paso.

Paso 5: Cargar tu primer dataset

Descarga una muestra pequeña de dominio público: shapefile de países Natural Earth 1:110m y cárgala mediante la interfaz de GeoLens. 

curl -LO https://naturalearth.s3.amazonaws.com/110m_cultural/ne_110m_admin_0_countries.zip

En la interfaz de GeoLens, haz clic en el botón de carga del encabezado del catálogo, selecciona el archivo ZIP y confirma el CRS detectado (EPSG:4326). Haz clic en Commit para publicar. El dataset aparecerá en el catálogo y estará disponible mediante OGC API en http://localhost:8080/api/collections.

Lo que verás

Después del paso 5, el dataset que subiste aparece en el catálogo GeoLens. A medida que agregas más datos, el catálogo se llena como el de abajo: tarjetas de datasets con búsqueda, insignias de tipo y filtros por facetas. La vista previa del mapa, el panel de metadatos y los endpoints OGC API en http://localhost:8080/api/collections están activos. Usa la barra de búsqueda para filtrar datasets, abre una tarjeta para ver metadatos y entra al constructor de mapas para componer mapas multicapa.

Solución de problemas

  • Conflicto de puertos - Si el puerto 5434, 8001 o 8080 ya está en uso por otro servicio, edita .env y cambia DB_PORT, API_PORT o FRONTEND_PORT a valores libres. Luego ejecuta docker compose down && docker compose up -d --build para aplicar.
  • Falla el inicio de sesión admin - Confirma que GEOLENS_ADMIN_USERNAME y GEOLENS_ADMIN_PASSWORD en .env coincidan con lo que escribes. Después de editar .env, reinicia los servicios con docker compose restart api.
  • Los servicios tardan en iniciar - El primer docker compose up compila imágenes y descarga ~1 GB de capas base. Observa el progreso con docker compose logs -f. Los inicios posteriores son casi instantáneos.
  • Falla la carga de archivos - Confirma que el archivo sea uno de los formatos compatibles: GeoJSON, Shapefile ZIP, GeoPackage, CSV o una URL pública de servicio OGC. Revisa el diálogo de carga para ver errores de validación.

Siguientes pasos