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
  • ✓ ~4 GB de RAM libre - para Postgres, PostGIS, la API y el contenedor frontend
  • ✓ ~10 GB de disco - para las imágenes base de Postgres + PostGIS descargadas en la primera compilación
  • ✓ Puertos locales abiertos: - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)

Paso 1: Obtener el código

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:

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

Paso 2: Configurar el entorno

Copia el archivo .env de ejemplo. Los valores predeterminados funcionan para desarrollo local; no necesitas editar nada salvo que quieras cambiar el usuario o la contraseña de administrador.

cp .env.example .env
Cambiar en producción: Tres variables en .env.example están marcadas para cambiarse en producción: POSTGRES_PASSWORD, JWT_SECRET_KEY y GEOLENS_ADMIN_PASSWORD. Para evaluación local puedes dejarlas como están.

Paso 3: Iniciar servicios

docker compose up -d --build

La primera compilación descarga imágenes base de Postgres + PostGIS (~1 GB). Los inicios posteriores tardan menos de 10 segundos. Verifica que todos los servicios estén ejecutándose:

docker compose ps

Los servicios api, db y frontend deben mostrar estado running.

Paso 4: Iniciar sesión y verificar

Abre la interfaz de GeoLens en tu navegador:

http://localhost:8080

Inicia sesión con las credenciales predeterminadas de .env.example:

  • Usuario: admin
  • Contraseña: admin

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

Lo que verás

Después del paso 5, tu navegador muestra el catálogo GeoLens con tu primer dataset. La vista previa del mapa, el panel de metadatos y los endpoints OGC API en http://localhost:8001/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