garage
Garage es un servidor de gestión vehicular autocontenido y self-hostable para el seguimiento del mantenimiento, combustible y viajes OBD/GPS. Permite registrar servicios de combustible, realizar revisiones mecánicas, gestionar flotas y acceder a datos telemétricos vía OBD.
Ficha actualizada 22 sept 2026, 22:52 · upstream 22 sept 2026, 22:48 · release v1.5.2
Qué es garage
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Garage es una plataforma completa de gestión vehicular diseñada para hogares con múltiples vehículos o pequeñas flotas. Su arquitectura se basa en Node.js con Next.js como frontend y PostgreSQL/Redis como backend. Incluye un panel de administración, aplicaciones móviles (iOS/Android), integración con Home Assistant y soporte para vehículos eléctricos e híbridos. La aplicación permite registrar viajes, combustible, revisiones mecánicas, gestionar flotas y acceder a datos telemétricos vía OBD-II.
- Gestión de mantenimiento preventivo y correctivo por vehículo
- Registro de viajes y consumo de combustible
- Seguimiento de flotas vehiculares con múltiples usuarios
- Integración con Home Assistant para automatización del hogar
- Acceso a datos telemétricos (OBD/GPS) sin necesidad de hardware adicional
- Gestión de vehículos eléctricos y híbridos con seguimiento de carga
- Registro de servicios de combustible y mantenimiento legal
- Arquitectura modular con Fastify API y Next.js frontend, escalable y fácil de mantener
- Soporte completo para vehículos eléctricos (OBD II) e híbridos con telemetría en tiempo real
- Integración nativa con Home Assistant mediante HACS como componente personalizado
- Diseño móvil-first con navegación inferior intuitiva y modo oscuro
- Sistema de gestión de usuarios con roles diferenciados (administrador, usuario general)
- API RESTful completa para integración con aplicaciones externas
- La aplicación requiere un servidor web (Node.js) y una base de datos PostgreSQL para funcionar
- No incluye un panel de administración completo en la versión inicial; se recomienda usar Proxmox LXC o Docker Compose
- El soporte para vehículos eléctricos está en fase beta y no cubre todos los modelos disponibles
- La integración con Home Assistant requiere una configuración manual del componente HACS
- No incluye un sistema de autenticación en dos factores (2FA) por defecto
- La interfaz gráfica es responsiva pero no se adapta a pantallas táctiles pequeñas
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar Garage, recomiendo usar Proxmox con LXC para una instalación rápida y segura. Ejecuta el script `proxmox/ct/garage.sh` que genera un contenedor Linux aislado. O usa Docker Compose: ejecuta `docker compose -f docker-compose.prod.yml up -d`. En producción, despliega en Kubernetes o Cloud Foundry. Configura un proxy (Caddy) para HTTPS y elige entre PostgreSQL 16 o MariaDB como base de datos. Activa la integración con Home Assistant mediante HACS al instalar Garage. Para migrar usuarios existentes, ejecuta `docker compose -f docker-compose.prod.yml run --rm api npx prisma migrate resolve --rolled-back` antes de aplicar los cambios.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.