May - Gestor de veh铆culos autohospedado en Docker

May | Vehicle Management | Docker

May: Gestor de veh铆culos autohospedado en Docker para rastrear combustible y gastos

Dashboard minimalista para gestionar flotilla de veh铆culos. Log de combustible, c谩lculo autom谩tico MPG/L100km. Gastos, mantenimiento, recordatorios. Multi-usuario. Flask + SQLite. Self-hosted. Privado.

¿Qu茅 es May?


May es un gestor de veh铆culos autohospedable minimalista que proporciona un dashboard limpio para rastrear combustible, gastos, mantenimiento y recordatorios de todos tus veh铆culos. Dise帽ado para quien quiere control total de datos de su flotilla sin confiar en aplicaciones SaaS. Tiene toda la funcionalidad que necesita un due帽o de flota: tracking de combustible, c谩lculo autom谩tico de consumo, seguimiento de gastos (mantenimiento, seguros, reparaciones, impuestos), recordatorios, documentos adjuntos, acceso multi-usuario, y an谩lisis gr谩ficos.

Nombramiento curioso: Llamado "May" en honor a James May (Top Gear), completando el tr铆o con Clarkson (otro proyecto) y Hammond (imaginario). Solo por diversi贸n.

Caracter铆sticas principales: Soporte multi-veh铆culos con tipos custom (cars, vans, motos, scooters). Log de combustible con c谩lculo autom谩tico consumo (L/100km, MPG). Modo entrada r谩pida para logging 谩gil. Tracking de gastos por categor铆a (mantenimiento, seguros, reparaciones, impuestos, etc). Gastos recurrentes (seguros, impuestos, suscripciones). Calendarios de mantenimiento programado. Recordatorios (MOT, service, seguros, impuestos). Documentos adjuntos. Analytics gr谩ficos. Notificaciones (email, Pushover, ntfy, webhooks). Dark mode. PWA (app en el m贸vil). Integraci贸n calendario. B煤squeda UK DVLA. API REST. Generaci贸n de reportes PDF. Multi-usuario. Open source. Flask + SQLite + HTMX + Tailwind CSS.

Para due帽os de veh铆culos: Un solo lugar para toda la gesti贸n: combustible, gastos, mantenimiento, recordatorios. Control total de datos. Sin subscripciones. Sin tracking.

Caracter铆sticas principales

Multi-veh铆culo

Track autos, motos, vans, scooters. Tipos custom. Cada uno con historial independiente.

Log de combustible

Registra cada gasolina. C谩lculo autom谩tico MPG, L/100km, consumo promedio.

Modo entrada r谩pida

Interface streamlined para logging veloz. Sin fricciones.

Tracking de gastos

Mantenimiento, seguros, reparaciones, impuestos, etc. Categorizado. Hist贸rico.

Gastos recurrentes

Seguros anuales, impuestos, suscripciones. Auto-recurrentes. Reminders.

Mantenimiento programado

Calendarios por mileage o fecha. Track qu茅 est谩 pendiente.

Recordatorios

MOT, service, seguros, impuestos. Email, Pushover, ntfy, webhooks.

Documentos

Adjunta recibos, seguros, registros. Todo centralizado.

Analytics

Gr谩ficos interactivos. Consumo a lo largo del tiempo. Gastos totales.

Multi-usuario

Acceso para familia, equipo. Permisos granulares.

Dark mode

Interface clara o oscura. Seleccionable.

API REST

Para integraciones custom. Automatizaci贸n.

Requisitos del sistema

  • Docker & Docker Compose
  • 256 MB - 1 GB RAM (muy ligero)
  • 1-2 GB espacio disco (depende datos hist贸ricos)
  • Puerto 5050 (configurable)
  • SQLite (incluido, no requiere PostgreSQL)
  • Navegador moderno
Ultra-ligero: Perfect para Raspberry Pi, NAS, VPS barato. Bajo overhead.

Instalaci贸n con Docker Compose

Paso 1: Crear docker-compose.yml

cat > docker-compose.yml << 'EOF' version: '3.8' services: may: image: ghcr.io/dannymcc/may:latest container_name: may-vehicle-tracker restart: unless-stopped ports: - "5050:5050" volumes: - may_data:/app/data environment: # Secret key para sesiones (genera uno fuerte) - SECRET_KEY=tu-secret-key-super-seguro-aqui # Contrase帽a admin (si no la pones, genera una random) - ADMIN_PASSWORD=CambiaAlAdmin123! # Base de datos (SQLite por defecto) - DATABASE_URL=sqlite:////app/data/may.db # Carpeta uploads - UPLOAD_FOLDER=/app/data/uploads volumes: may_data: EOF

Paso 2: Generar SECRET_KEY fuerte

python3 -c "import secrets; print(secrets.token_hex(32))" # Copia el resultado y reemplaza en docker-compose.yml

Paso 3: Iniciar con Docker

docker compose up -d # Espera 10-15 segundos docker compose logs may-vehicle-tracker # Si ADMIN_PASSWORD no est谩 set, ver谩s password random en logs

Acceder

http://localhost:5050 - May dashboard

Primer login

  • Username: admin
  • Password: La que estableciste en ADMIN_PASSWORD env, o la random generada (ver logs)
  • IMPORTANTE: Cambiar password inmediatamente despu茅s de login

Primeros pasos

1. Login y cambiar contrase帽a

  1. Accede a http://localhost:5050
  2. Username: admin, Password: (la que configuraste)
  3. Inmediatamente: Settings → Change Password (muy importante!)

2. Personalizar May

  1. Settings → Branding
  2. Personaliza nombre, logo, colores (opcional)
  3. Save

3. Agregar tu primer veh铆culo

  1. Dashboard → "+ Add Vehicle"
  2. Tipo: Car / Van / Motorcycle / Scooter / Custom
  3. Nombre: "Mi auto 1", "Moto Honda", etc
  4. Matr铆cula (n煤mero veh铆culo)
  5. Informaci贸n: marca, modelo, cilindrada, etc
  6. Save

4. Registrar tu primer tanque de gasolina

  1. Dashboard → Veh铆culo → "Log Fuel"
  2. Fecha
  3. Mileage (km actuales)
  4. Litros/Galones consumidos
  5. Precio pagado (opcional)
  6. Save
  7. May calcula autom谩ticamente: MPG, L/100km, consumo promedio

5. Registrar un gasto

  1. Dashboard → Veh铆culo → "Add Expense"
  2. Categor铆a: Maintenance, Insurance, Repair, Tax, Registration, Consumables, Other
  3. Monto
  4. Descripci贸n: "Service cambio aceite", "Seguro anual", etc
  5. Fecha
  6. Mileage (opcional)
  7. Recurrencia (si es anual, mensual, etc)
  8. Save

6. Configurar recordatorios

  1. Dashboard → Veh铆culo → "Maintenance"
  2. Add Service Reminder: MOT, Service, Insurance, Tax, etc
  3. Fecha pr贸xima
  4. Frecuencia (anual, cada 6 meses, cada 10,000km, etc)
  5. Save
  6. May enviar谩 reminders por email/Pushover/ntfy cuando se acerque

7. Ver analytics

  1. Dashboard → Veh铆culo → "Analytics"
  2. Gr谩ficos de consumo, gastos totales, mileage trend
  3. Descarga reportes PDF

8. Agregar m谩s usuarios

  1. Settings → Users → "Add User"
  2. Email, password, rol (admin/user)
  3. Save
  4. Ellos pueden loguearse y ver todos los veh铆culos o solo los asignados

Casos de uso

  • Due帽os de autos personales: Track combustible, gastos, mantenimiento. Un solo lugar.
  • Flotas peque帽as (taxis, delivery): Gestiona m煤ltiples veh铆culos, conductores, costos.
  • Empresas: Track flotilla, costos operacionales, mantenimiento preventivo.
  • Compliance/Auditor铆a: Documentaci贸n completa de gastos, mantenimiento, historial.
  • Motociclistas: Track consumo, gastos, servicios de tus motos.

HTTPS con Caddy (producci贸n)

Caddyfile

vehicles.tudominio.com { reverse_proxy localhost:5050 }

Acceso remoto seguro

https://vehicles.tudominio.com con HTTPS autom谩tico de Caddy

Gesti贸n y mantenimiento

Ver logs

docker compose logs -f may-vehicle-tracker

Backup de datos

docker cp may-vehicle-tracker:/app/data ./may-backup-$(date +%Y%m%d) # O backup del volumen docker run --rm -v may_data:/data -v $(pwd):/backup alpine tar czf /backup/may-$(date +%Y%m%d).tar.gz -C /data .

Restore de backup

docker run --rm -v may_data:/data -v $(pwd):/backup alpine tar xzf /backup/may-20260522.tar.gz -C /data

Reiniciar

docker compose restart may-vehicle-tracker

Actualizar a versi贸n m谩s reciente

docker compose pull docker compose up -d

Monitorear consumo

docker stats may-vehicle-tracker

Comparativa con alternativas

vs Fuelly (SaaS)

May gana: Self-hosted, privado, sin suscripci贸n, offline. Fuelly gana: Comunidad, comparativas, m谩s maturo.

vs Spritmonitor (SaaS)

May gana: Control total, no cloud, sin tracking. Spritmonitor gana: Comunidad competitiva, ranking.

vs Hoja de c谩lculo Excel

May gana: Interface bonita, c谩lculos autom谩ticos, reminders, analytics. Excel gana: Flexibility total.

Mejor para: Quien quiere tracker minimalista de veh铆culos sin confiar en SaaS. Control total. Bajo overhead. Privado.

Referencias oficiales

Apoya el canal GENBYTE

Suscr铆bete al canal de YouTube Suscr铆bete a la newsletter semanal Inv铆tame a un Ko-fi genbyte@proton.me

S铆gueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter

Comentarios

Publicar un comentario

Comenta...

Entradas populares de este blog

Soluci贸n al error: «user is not in the sudoers file» en Debian

Imagen
  Soluci贸n al error: «user is not in the sudoers file» en Debian Acabas de instalar Debian, abres la terminal para actualizar el sistema con: sudo apt update y, de repente, aparece el siguiente error: user is not in the sudoers file. This incident will be reported. Si es tu primera vez con Debian seguramente pienses:  “¿Qu茅 he hecho mal?” . Tranquilo, no es culpa tuya. Este problema es bastante habitual en Debian porque, a diferencia de Ubuntu, el primer usuario creado durante la instalaci贸n no siempre se a帽ade autom谩ticamente al grupo  sudo . La buena noticia es que la soluci贸n es muy sencilla. ¿Por qu茅 aparece este error en Debian? El error indica que tu usuario actual no tiene permisos para ejecutar comandos como administrador. En Debian, esos permisos se gestionan a trav茅s del archivo  /etc/sudoers  o mediante el grupo  sudo . 馃憠 En resumen: tu usuario no est谩 autorizado para usar  sudo , pero el sistema funciona perfectamente. Soluci贸n paso a...
Leer m谩s

NAS SYNOLOGY DSM 7.1 en VMware ESXI - Gu铆a instalaci贸n y configuraci贸n Synology DSM 7.1 en VMWARE

Imagen
"NAS Synology en VMware - Gu铆a instalaci贸n y configuraci贸n Synology DSM 7.1" Descarga los ficheros desde este enlace: https://mega.nz/file/ZTwnGaKQ#HreeTekfsAFJhCMQmoGKG4AooZXE8_3xPcTrgRgwV_U Contrase帽a: bilaljebari V铆deo del proceso explicado paso a paso. ⏭馃摷 https://www.youtube.com/@genbyte?sub_confirmation=1 馃憤❤️馃敂 Apoya mi canal. Suscr铆bete y activa la campana para recibir los 煤ltimos v铆deos. Otros v铆deos Instalaci贸n VMWare ESXI https://www.youtube.com/watch?v=8VXg78ayPAQ Instalaci贸n NAS Synology en PC/Servidor https://www.youtube.com/watch?v=CBGxjHVyBq8
Leer m谩s

Multisesi贸n RDP en Windows 10 Pro

Imagen
Multisesi贸n RDP en Windows 10 Pro Los usuarios pueden conectarse a sus ordenador con Windows 10 y 11 a trav茅s de los Servicios de escritorio remoto (RDP). Basta con habilitar RDP en la configuraci贸n del dispositivo y conectarse a la computadora usando cualquier cliente de Escritorio remoto. Pero existe una restricci贸n en la cantidad de sesiones RDP simult谩neas: solo un usuario remoto puede trabajar simult谩neamente. Si intenta abrir una segunda sesi贸n RDP, aparecer谩 una advertencia pidi茅ndole que desconecte la sesi贸n del primer usuario. Entonces nos preguntamos, ¿Alguna soluci贸n a esto?. La respuesta es s铆, y aqu铆 te traigo c贸mo hacerlo. Para habilitar y configurar multisesi贸n de escriorio remoto en Windows 10 Pro, para ello vamos a aprovechar de la herramienta RDP Wrapper Library. Esta herramienta es de c贸digo abierto que nos permite habilitar m煤ltiples sesiones en Windows 10 sin modificar termsrv.dll Los ficheros necesarios as铆 como gu铆a est谩n en este enlace. Sigue los pasos para cons...
Leer m谩s