Inicio rápido: instala GeoLens localmente
Sigue estos pasos para pasar de curl -fsSL https://getgeolens.com/install.sh | sh 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.
La mayoría de las instalaciones están en marcha en pocos minutos; una compilación desde el código fuente tarda de 5 a 10 minutos.
¿Aún no quieres ejecutar Docker? Sáltate la instalación y explora la demo en vivo
Requisitos previos
- ✓ Git y curl - el instalador clona el repositorio y descarga por HTTPS
- ✓ Docker Engine 24.0+ - desde Docker Desktop o los paquetes de Docker Engine
- ✓ Docker Compose v2.20+ - incluido en las versiones actuales de Docker Desktop, o instala el plugin compose aparte
- ✓ Memoria: - 8 GB o más disponibles para Docker: el instalador avisa por debajo de 7 GB
- ✓ Puertos locales abiertos: - 5434 (PostgreSQL), 8001 (API), 8080 (Frontend UI)
Paso 1: Ejecutar el instalador público
Primera ejecución recomendada:
curl -fsSL https://getgeolens.com/install.sh | sh El instalador clona en un directorio geolens. Ejecuta el resto de comandos de esta página desde dentro de él:
cd geolens ¿Prefieres un checkout del código fuente o el tarball de una versión? Clona el repositorio y ejecuta bash scripts/install.sh desde él. Instalar desde el código fuente (se abre en una pestaña nueva)
Paso 2: Iniciar sesión
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
Para mostrar una contraseña generada, ejecuta esto desde el directorio geolens:
grep '^GEOLENS_ADMIN_PASSWORD=' .env El instalador espera a que todos los servicios estén en buen estado. Para comprobarlos tú mismo, ejecuta docker compose ps.
¿Vas más allá de una prueba local? Elige una contraseña de administrador robusta cuando el instalador la pida y luego lee la guía de despliegue en la nube (se abre en una pestaña nueva).
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 3: 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 Crear en el encabezado, elige Importar datos y selecciona el archivo ZIP. GeoLens detecta el CRS (EPSG:4326) y el esquema; confirma la importación para publicar. El dataset aparece en la búsqueda del catálogo. Las importaciones son privadas de forma predeterminada, así que la OGC API en http://localhost:8080/api/collections solo lo lista en solicitudes autenticadas (envía un token de portador) o cuando hagas público el dataset. Abrir esa dirección en el navegador es una solicitud anónima, así que solo muestra la colección del catálogo.
La muestra de Natural Earth incluye la Antártida, por lo que la importación recorta dos entidades en el límite de Web Mercator y la página del dataset muestra una advertencia sobre las coordenadas de origen. Con esta muestra la advertencia es lo esperado.
Lo que verás
Después del paso 3, 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; los datasets privados solo aparecen ahí en solicitudes autenticadas. 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.
Paso 4 (opcional): Cargar los mapas de demostración
¿Prefieres un catálogo completo en vez de un solo dataset? El repositorio incluye un script que construye siete mapas de demostración con datos abiertos públicos, incluido el horizonte 3D de Manhattan de la portada, además de una historia publicada y un mapa con panel. Desde el directorio geolens que creó el instalador:
pip install httpx
python scripts/seed-showcase.py --username admin --password "$(grep '^GEOLENS_ADMIN_PASSWORD=' .env | cut -d= -f2-)" Requiere acceso a internet a las fuentes de datos abiertos.
Solución de problemas
- Conflicto de puertos - Cambia DB_PORT, API_PORT o FRONTEND_PORT en .env a puertos libres y reinicia el stack. Conflictos de puertos (se abre en una pestaña nueva)
- Falla el inicio de sesión admin - Ejecuta grep '^GEOLENS_ADMIN' .env para ver las credenciales. La cuenta se crea en el primer arranque, así que editar .env después no la cambia; otro administrador puede restablecer la contraseña. Restablecer una contraseña (se abre en una pestaña nueva)
- Los servicios tardan en iniciar - Los checkouts del código fuente compilan las imágenes localmente y tardan más que las instalaciones de versión. Sigue el progreso con docker compose logs -f. Servicios que no arrancan (se abre en una pestaña nueva)
- Falla la carga de archivos - Comprueba que el archivo tenga uno de los formatos que lista la página Importar datos y revisa los errores de validación en el diálogo de carga. Formatos admitidos (se abre en una pestaña nueva)
Siguientes pasos
- Crea tu primer mapa (se abre en una pestaña nueva)
- Conecta QGIS a GeoLens (se abre en una pestaña nueva)
- Invita a tu equipo y asigna roles (se abre en una pestaña nueva)
- Configura la instancia (se abre en una pestaña nueva)
- Actualiza GeoLens (se abre en una pestaña nueva)
- Copias de seguridad y restauración (se abre en una pestaña nueva)
- Consulta el código fuente y contribuye en GitHub