Cómo instalar Jetlog en Docker - Personal Flight Tracker en Docker - Registrador de vuelos autohospedado
Jetlog en Docker: Registrador de vuelos personal autohospedado. Mapa mundial de vuelos, estadísticas, multi-usuario, import/export, privacidad garantizada 🛫✈️
Jetlog es un flight tracker personal autohospedado. Visualiza todos tus vuelos en mapa mundial. Estadísticas detalladas (distancia, altitud, duraciones). Añade, edita, elimina vuelos manualmente. Soporte multi-usuario. Import desde MyFlightRadar24, CSV. Export a CSV, iCal. Autenticación segura. 100% privacidad en tu homelab. FastAPI + React + SQLite + TailwindCSS. GPL-2.0 open source.
¿Qué es Jetlog?
Jetlog es un registrador de vuelos personal autohospedado que permite registrar, visualizar y gestionar todos tus vuelos en un mapa mundial interactivo, con estadísticas detalladas, soporte multi-usuario, y opciones de import/export, garantizando 100% privacidad sin depender de aplicaciones terceras. Ideal para pilotos, viajeros frecuentes y entusiastas de aviación.
Propuesta clave: Flight tracker personal fully self-hosted. Mapa mundial interactivo (Leaflet + GeoJSON). Visualizar todos tus vuelos históricos. Estadísticas: distancia total, altitud, duración, aeropuertos visitados. Añadir vuelos manualmente (fecha, origen, destino, aeronave, notas). Editar/eliminar vuelos. Multi-usuario con autenticación segura. Import desde MyFlightRadar24, CSV personalizado. Export a CSV, iCal (para calendarios). API externa opcional (adsbdb flight data). Single source of truth en SQLite. Responsive design mobile/desktop. FastAPI backend, React frontend. Zero cloud, zero tracking. 100% privacidad. GPL-2.0 open source. Perfecto para homelabs.
Características principales
Mapa mundial interactivo
Visualiza todos tus vuelos en mapa. Zoom, pan, markers interactivos. GeoJSON world borders.
Estadísticas detalladas
Distancia total volada, altitud máxima, duración promedio, aeropuertos visitados.
Gestión vuelos
Añadir, editar, eliminar vuelos. Campos: fecha, origen, destino, aeronave, notas.
Multi-usuario seguro
Autenticación integrada. Múltiples usuarios independientes. Control acceso.
Import automático
Import desde MyFlightRadar24, CSV personalizado. Importa histórico vuelos.
Export flexible
Export a CSV (backup). Export a iCal (añade vuelos a calendario).
Responsive design
Mobile-first. Funciona perfecto en smartphone, tablet, desktop.
100% privacidad
Self-hosted. Sin cloud. Sin tracking. Sin ads. Control total datos.
Requisitos del sistema
- Docker & Docker Compose v2+
- 512 MB - 2 GB RAM mínimo (aplicación ligera)
- 1 GB espacio disco (SQLite database muy pequeño)
- Puerto TCP disponible: 3000 (configurable)
- CPU: 1+ core (muy ligero)
- Acceso internet (opcional: para import flights, external APIs)
Estructura directorios /mnt/media
Jetlog necesita solo una carpeta pequeña:
Instalación con Docker Compose
Paso 1: Preparar estructura directorios
Paso 2: Crear docker-compose.yml
Paso 3: Generar SECRET_KEY seguro
Paso 4: Iniciar Jetlog
Acceder a Jetlog
🛫 Jetlog Web UI: http://localhost:3000
Credenciales por defecto
- Usuario:
admin - Contraseña:
admin
http://192.168.1.100:3000 (reemplaza con tu IP)Para obtener tu IP:
hostname -I
Primeros pasos
1. Login y cambiar contraseña
- Abre
http://localhost:3000 - Login: usuario
admin, contraseñaadmin - Ve a Settings → Change Password
- Establece contraseña nueva segura
2. Explorar interfaz
- Home: Resumen estadísticas personales
- Map: Visualiza todos tus vuelos en mapa mundial
- All Flights: Lista detallada de vuelos
- Settings: Configuración cuenta, password, preferencias
3. Agregar vuelo manualmente
- En lista de vuelos, click "Add Flight"
- Rellena campos:
- Date: fecha vuelo
- Departure: aeropuerto salida (código IATA, ej: MAD)
- Arrival: aeropuerto llegada (código IATA, ej: BCN)
- Aircraft: tipo aeronave (opcional)
- Notes: notas adicionales (opcional)
- Click "Add Flight" → se añade a tu historial
- Mapa se actualiza automático
4. Import vuelos desde CSV
- Prepara archivo CSV con formato:
# Ejemplo CSV format date,departure,arrival,aircraft,notes 2024-01-15,MAD,BCN,EC-JXX,Vuelo 1234 2024-02-20,BCN,CDG,EC-JXX,Vuelo 2345
- En Settings → Import, selecciona archivo CSV
- Jetlog importa automático todos los vuelos
- Verifica mapa que se agregaron correctamente
5. Import desde MyFlightRadar24
- Ve a MyFlightRadar24.com, exporta tu historial vuelos (CSV)
- En Jetlog Settings → Import, selecciona "MyFlightRadar24"
- Sube el archivo
- Jetlog mapea automático campos y importa
6. Ver estadísticas
- Home → muestra resumen personal:
- Total flights: cuántos vuelos registrados
- Total distance: km totales volados
- Total time: horas totales vuelo
- Highest altitude: altitud máxima alcanzada
- Unique airports: aeropuertos únicos visitados
- Click en cualquier estadística para detalles
7. Visualizar mapa mundial
- Click "Map" → mapa mundial interactivo
- Se muestran todos tus vuelos como líneas origen → destino
- Markers en aeropuertos visitados
- Zoom/pan para ver detalles
- Click en vuelo para ver detalles (fecha, aeronave, etc)
8. Export datos
- Settings → Export
- CSV Export: descarga todos tus vuelos como CSV (backup)
- iCal Export: añade todos tus vuelos a calendario (compatible Apple Calendar, Google Calendar, Outlook)
9. Multi-usuario (agregar más usuarios)
- Admin panel → Users
- Click "Add User"
- Especifica username, email, password
- Nuevo usuario puede login independiente
- Cada usuario tiene su propio historial vuelos
Casos de uso
- Pilotos privados: Registra todas tus horas de vuelo. Logbook autohospedado.
- Viajeros frecuentes: Visualiza todos tus vuelos históricos. Estadísticas de viajes.
- Entusiastas aviación: Colecciona aeropuertos visitados. Mapa mundial interactivo.
- Privacidad: Sin cloud. Sin tracking. Sin depender de apps terceras.
- Homelabs: Ultra-ligero. Perfecto para Raspberry Pi, VPS pequeño.
Configuración avanzada
Variables de entorno
- JETLOG_PORT: Puerto web (default: 3000)
- SECRET_KEY: String segura para autenticación (CAMBIAR)
- ENABLE_EXTERNAL_APIS: true/false (default: true) - usa adsbdb para fetch flights automático
Ejecutar bajo path prefix (ej: /jetlog)
Privacy: deshabilitar external APIs
Gestión y mantenimiento
Ver estado
Ver logs
Restart Jetlog
Actualizar a versión nueva
Monitorear consumo
Detener Jetlog
Backup datos
Restore datos desde backup
Stack técnico
- Backend: FastAPI (Python) - API REST, autenticación, lógica
- Frontend: React + TypeScript - interfaz web moderna, responsive
- Database: SQLite - almacenamiento vuelos, usuarios, configuración
- Styling: TailwindCSS - diseño limpio, responsive mobile
- Maps: react-simple-maps (Leaflet) - mapa mundial interactivo
- External APIs: adsbdb (opcional) - auto-fetch flight data
- Licencia: GPL-2.0 open source
Comparativa con alternativas
vs MyFlightRadar24
Jetlog gana: Self-hosted, privacidad 100%, gratuito, sin ads, open source, datos en tu homelab. MyFlightRadar24 gana: UI pulida, datos oficiales aviones reales.
vs Flighty
Jetlog gana: Self-hosted, gratuito, privacidad. Flighty gana: Tracking en tiempo real, notificaciones push.
vs Logbook.aero
Jetlog gana: Self-hosted, gratuito, open source. Logbook.aero gana: Features profesionales pilotaje.
Comentarios
Publicar un comentario