VehicleVault
v1.0.20
ghcr.io/teecodedev/vehiclevault:latest
https://ghcr.io/teecodedev/vehiclevault
bridge
3001
sh
false
https://github.com/TeeCodeDev/VehicleVault/issues
https://github.com/TeeCodeDev/VehicleVault
VehicleVault is a modern, privacy-first, self-hosted vehicle lifecycle, fuel, maintenance, digital glovebox, and TCO (Total Cost of Ownership) platform. Built with a responsive React PWA, Node.js TypeScript API, Tesseract OCR receipt scanner, and Model Context Protocol (MCP) server for AI assistants.
[b]Key Features:[/b]
- [b]Fleet & Garage Management:[/b] Multi-vehicle profiles (cars, motorcycles, trailers, vans) with cover photos, specifications, and telemetry.
- [b]Dutch RDW Open Data:[/b] 1-click license plate autofill and automated background APK expiry monitoring with alert notifications.
- [b]Quick-Log Fueling & OCR Scanner:[/b] Fast mobile PWA fueling interface with built-in Tesseract OCR for automatic receipt parsing (liters, €/L, total cost).
- [b]Digital Glovebox & Documents:[/b] Secure vault for registrations, insurance green cards, APK reports, garage invoices, and user manuals with category filters.
- [b]Dual-Trigger Maintenance Engine:[/b] Track distance and time service intervals with parts vs. labor cost split and DIY savings indicator.
- [b]Dynamic TCO & Tank Analytics:[/b] Operational vs. asset TCO with purchase price toggle, tank range metrics, fuel price evolution, and gas station comparisons.
- [b]Digital Service Dossier:[/b] Generate downloadable, clean PDF service booklets suitable for vehicle sales or insurance archives.
- [b]Offline Mode & PWA:[/b] Offline caching with an offline fuel queue that automatically synchronizes when connectivity is restored.
- [b]AI Integration (MCP):[/b] Built-in Model Context Protocol (MCP) server for Claude Desktop, Antigravity, and AI agents via stdio or authenticated HTTP/SSE.
- [b]Multi-Language:[/b] Full Dutch (NL) and English (EN) interface switchable in settings.
[b]Initial Setup:[/b]
Open the web interface at [inline]http://[IP]:[PORT:3001]/[/inline]. The first user registered will automatically be granted Administrator privileges.
Tools:Utilities Productivity: Other:
http://[IP]:[PORT:3001]/
https://raw.githubusercontent.com/TeeCodeDev/unraid-templates/main/templates/VehicleVault.xml
https://raw.githubusercontent.com/TeeCodeDev/VehicleVault/main/README.md
vehiclevault vehicle car auto maintenance garage fuel mileage rdw apk odometer oil tco lube logger tracktor mcp pwa
MIT
https://raw.githubusercontent.com/TeeCodeDev/VehicleVault/main/client/public/icon-512.png
2026-10-29
If you like VehicleVault, buy me a coffee!
https://ko-fi.com/D1D51ZGUNL
### v1.0.16 (2026-10-29)
- [b]Pangolin & Reverse Proxy Multi-User Resolving:[/b] Pangolin Remote-User & Remote-Email headers hebben nu altijd voorrang boven no-auth, zodat verschillende Pangolin-accounts direct als hun eigen gebruiker en rol (Chauffeur vs Beheerder) herkend worden.
- [b]Gebruiker Toevoegen Wizard:[/b] Nieuwe knop in Instellingen > Gebruikers & Toegang om vooraf een gezinslid of testaccount toe te voegen met rol Chauffeur of Beheerder.
### v1.0.15 (2026-10-29)
- [b]Voertuig Bewerken & Brandstoftype Dropdown:[/b] Vrij tekstveld vervangen door een dropdown met alle gangbare brandstof- en hybridesoorten. Uitlijning van aankoopstand en aanschafprijs strak gecorrigeerd.
- [b]RDW Brandstof & Hybride Detectie:[/b] RDW-autofill vraagt nu automatisch het officiële RDW-brandstofregister uit en herkent automatisch HEV, PHEV, EV, Benzine en Diesel.
- [b]Slimme Tankbeurt / Laadbeurt Interface:[/b] De Liters/kWh-schakelaar wordt automatisch verborgen voor brandstof- en reguliere hybride auto's (en toont direct Laadbeurt voor EV's). De schakelaar is alleen actief bij Plug-in Hybrides (PHEV).
- [b]Documenten Upload & Compressie:[/b] Automatische browser-compressie toegevoegd aan de Documenten-module (< 350 KB). Foutoplossing voor multer uploadnaam ('file' en 'document') en gezinsvloot permissies.
### v1.0.14 (2026-10-29)
- [b]Gebruikersrollen & Chauffeur-Modus:[/b] Ondersteuning voor meerdere gebruikers met rollen (Beheerder vs Chauffeur). Chauffeur-modus biedt een vereenvoudigde interface op telefoon en desktop, ideaal voor gezinsleden om snel tank- of laadbeurten in te voeren.
- [b]Pangolin & Reverse Proxy Auto-Provisioning:[/b] Nieuwe gebruikers via Remote-User / X-Pangolin-User headers worden automatisch geregistreerd met instelbare rol.
- [b]Client-Side Bon-Compressie (< 350 KB):[/b] Foto's van bonnetjes (vaak 3-8 MB) worden direct in de browser via Canvas gecomprimeerd tot ~200 KB vóór verzending.
- [b]PHEV / EV Laadbeurten Ondersteuning:[/b] Tankbeurten formulier ondersteunt nu zowel Brandstof (Liters) als Laadbeurten (kWh en tarief per kWh).
- [b]Home Assistant REST Integratie:[/b] Live telemetrie endpoint (/api/integrations/ha/sensors) en kant-en-klare YAML configuratie met één-klik kopieerknop in Instellingen.
- [b]Notificatiesysteem (Ntfy, Gotify & Webhook):[/b] Automatische waarschuwingen bij naderende APK (< 30d, < 7d) en achterstallig onderhoud.
- [b]1-Klik Database & Bestanden Backup (.zip):[/b] Download met 1 klik een complete backup inclusief database en alle bijlagen, en zet backups eenvoudig terug.
- [b]Instellingen Opgesplitst in 5 Tabs:[/b] Instellingenknop naar onder verplaatst boven het versienummer; scherm netjes verdeeld over 5 thematische tabs.
### v1.0.13 (2026-10-28)
- Nieuw Hexagon Logo & PWA Iconen: Modern gestileerd hexagon-logo met transparante afwerking en Android/iOS maskable app-iconen.
- Nederlandse Datumnotatie (DD-MM-YYYY): Alle datums op het dashboard, tankbeurten overzicht (recente tankbeurten), onderhoudslijst, TCO-statistieken, API-sleutels en scanner preview worden nu consistent in het Nederlandse formaat (DD-MM-YYYY) weergegeven in plaats van ISO (YYYY-MM-DD).
- Verbeterde Adres Extractie van Tankbonnen: Versterkte AI-prompts en robuuste regex-extractie voor Nederlandse tankstationadressen (straat, huisnummer, postcode en stad direct onder het merk in de koptekst).
- Opschoning Gemini Modellen: Verouderde en niet-compatibele modellen (zoals TTS-, audio-, image- en preview-modellen) gefilterd uit de modelselectie; focus op snelle multimodale Flash-modellen (zoals Gemini 3.8 Flash).
- Provider Badge Tekst Geüpdatet: Badge tekst in Instellingen bijgewerkt naar "Flash • 100% accuraat & snel".
### v1.0.12 (2026-10-28)
- Inloggen Uitschakelen (Pangolin & Reverse Proxy Modus): Ondersteuning toegevoegd om inloggen volledig uit te schakelen via Instellingen of Docker omgevingsvariabele (DISABLE_AUTH=true).
- Reverse Proxy Integratie: Automatische herkenning van proxy auth headers (Remote-User, X-Forwarded-User, X-Pangolin-User).
- Directe Toegang als Beheerder: Bij uitgeschakelde authenticatie wordt de gebruiker direct als beheerder ingelogd zonder inlogscherm of verlopende sessies.
- UI Indicator & Toggle: Duidelijke No-Auth statusbadge in de navigatiebalk en eenvoudige schakelaar in Instellingen.
### v1.0.11 (2026-10-28)
- Automatische Tankstation Adres Extractie: AI Vision (OpenAI & Gemini) extraheert nu automatisch het volledige adres (straat, huisnummer, postcode en plaats) van het tankstation vanaf de bon en vult dit direct in het adresveld.
- Tankstation Naam Formattering: Tankstationnamen in hoofdletters (bijv. FIETEN OLIE) worden automatisch omgezet naar nette Title Case (Fieten Olie), met behoud van afkortingen zoals BP, Q8, AVIA en OK.
- AI Scanner Preview Verbetering: Het herkende adres wordt nu direct getoond in de scanner-popup onder het tankstation.
### v1.0.10 (2026-10-28)
- Google Gemini 3.8 Flash Migratie: Default Gemini model bijgewerkt naar gemini-3.8-flash zoals voorgeschreven door Google API (gemini-2.0-flash en 1.5-flash zijn door Google uitgefaseerd).
- Automatische Model Migratie: Bestaande installaties met 1.5-flash of 2.0-flash worden automatisch gemigreerd naar gemini-3.8-flash.
- Dynamische Model Detectie: Automatisch modellen ophalen via Google API en foutmeldingen automatisch ontleden om direct over te schakelen naar het geadviseerde model.
- Aanpasbaar Model Veld: Directe invoer en selectie van willekeurige AI-modellen in de instellingen.
### v1.0.8 (2026-10-28)
- Tankbeurten Bewerken: Potlood-icoon (Bewerken) toegevoegd aan de tabel Recente Tankbeurten onder Acties. Hiermee kunnen datum, kilometerstand, liters, literprijs, totaalbedrag, tankstation, adres, notities en gekoppelde bonnen/facturen achteraf worden gewijzigd.
- Backend PUT /api/fuel/:id endpoint toegevoegd met eigendomscontrole en automatische total-cost herberekening.
### v1.0.0 (2026-10-28)
- Initial release of VehicleVault.
- Fleet management with RDW open data integration and APK status alerts.
- Tesseract OCR receipt scanner for fuel fill-ups.
- Digital glovebox document repository for registrations, insurance, APK reports, and invoices.
- Dual-trigger maintenance intervals with parts and labor cost split and DIY savings tracking.
- Dynamic TCO engine, tank range analytics, and PDF service booklet export.
- Offline PWA caching with background synchronization queue.
- Model Context Protocol (MCP) server support for AI agents.
- Bilingual interface (Dutch and English).
false