https://github.com/homelabforge/mygarage

Self-hosted vehicle maintenance tracking for vehicle enthusiasts
https://github.com/homelabforge/mygarage

automotive fuel-tracking homelab maintenance-tracker recreational-vehicles trailers

Last synced: 3 months ago
JSON representation

Self-hosted vehicle maintenance tracking for vehicle enthusiasts

• Host: GitHub
• URL: https://github.com/homelabforge/mygarage
• Owner: homelabforge
• License: mit
• Created: 2025-12-02T08:01:28.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2026-03-25T15:50:57.000Z (3 months ago)
• Last Synced: 2026-03-26T13:04:20.161Z (3 months ago)
• Topics: automotive, fuel-tracking, homelab, maintenance-tracker, recreational-vehicles, trailers
• Language: Python
• Homepage: https://homelabforge.io/builds/mygarage/
• Size: 5.26 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          


  

Self-hosted vehicle maintenance tracking with VIN decoding, service records, fuel logging, and document management.


[![Docker Build](https://github.com/homelabforge/mygarage/actions/workflows/docker-build.yml/badge.svg)](https://github.com/homelabforge/mygarage/actions/workflows/docker-build.yml)

[![CodeQL](https://github.com/homelabforge/mygarage/actions/workflows/codeql.yml/badge.svg)](https://github.com/homelabforge/mygarage/actions/workflows/codeql.yml)

[![CI](https://github.com/homelabforge/mygarage/actions/workflows/ci.yml/badge.svg)](https://github.com/homelabforge/mygarage/actions/workflows/ci.yml)

[![Docker](https://img.shields.io/badge/Docker-Available-2496ED?logo=docker&logoColor=white)](https://github.com/homelabforge/mygarage/pkgs/container/mygarage)

[![Python 3.14](https://img.shields.io/badge/Python-3.14-3776AB?logo=python&logoColor=white)](https://www.python.org)

[![React 19](https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=black)](https://react.dev)

[![Bun 1.3.11](https://img.shields.io/badge/Bun-1.3.11-000000?logo=bun&logoColor=white)](https://bun.sh)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

[![Discord](https://img.shields.io/badge/Discord-Community-5865F2?logo=discord&logoColor=white)](https://discord.gg/6XttnVgG)

![MyGarage Dashboard](docs/screenshots/dashboard.png)



---

## Key Features

- **VIN Decoding** - Automatic vehicle details via NHTSA API

- **Service Visits** - Track maintenance with line items, tax/fees, and attachments

- **Maintenance Scheduling** - Proactive maintenance tracking with due date/mileage alerts

- **LiveLink Telemetry** - Real-time OBD2 data via WiCAN devices (HTTPS POST or MQTT)

- **POI Finder** - Discover nearby auto shops, EV charging, and fuel stations with interactive map

- **Fuel Tracking** - Log fill-ups with automatic MPG calculations

- **Fifth Wheel & Trailer Support** - Propane tracking, spot rental billing, and RV park management

- **Unit Conversion** - Imperial/Metric units with per-user preferences

- **Document Management** - Store registration, insurance, manuals with OCR

- **Family Multi-User System** - Separate accounts with vehicle sharing, ownership transfers, and family dashboard

- **Authentication Options** - No auth, local JWT, or OIDC (Authentik, Keycloak, Google, Azure AD)

- **Self-Hosted** - Your data stays on your infrastructure

---

**Default Mode**: Runs with no authentication for easy setup. Configure authentication in Settings before exposing to the internet.

📖 **[Complete Installation Guide](https://github.com/homelabforge/mygarage/wiki/Installation)**

## Support

- **📚 Documentation**: [GitHub Wiki](https://github.com/homelabforge/mygarage/wiki)

- **🌐 Website**: [homelabforge.io/builds/mygarage](https://homelabforge.io/builds/mygarage/)

- **🐛 Bug Reports**: [GitHub Issues](https://github.com/homelabforge/mygarage/issues)

- **💬 Discussions**: [GitHub Discussions](https://github.com/homelabforge/mygarage/discussions)

---

## License

MIT License - see [LICENSE](LICENSE) file for details.

---

## Acknowledgments

Built for homelabbers who want to track vehicle maintenance without sending data to third-party services.

VIN decoding powered by the [NHTSA vPIC API](https://vpic.nhtsa.dot.gov/).

### Community Contributors

| Contributor | Contribution |

|-------------|-------------|

| [Antonio (f0rZzZ)](https://github.com/f0rZzZ) | Polish, Russian, and Ukrainian translations |

### Development Assistance

MyGarage was developed through AI-assisted pair programming with **Claude** and **Codex**, combining human vision with AI capabilities for architecture, security patterns, and implementation.