Repository navigation
Notifications and Security
Under Settings β Meldingen (Notifications), configure automated alerts for:
- Approaching APK / Technical Inspections (within 30 days or overdue)
-
Maintenance Intervals (
warningat 90% oroverdueat 100%) - Expiring Glovebox Documents (insurance policies, green cards, warranties expiring within 30 days)
| Provider | Configuration |
|---|---|
| Web Push (PWA) | No account or settings needed: each person turns it on for their own device under Settings β Notifications β Web Push. Alerts go to every enabled device (see below) |
| Pushover | User Key + Application API Token + optional target Device name (priority 1 for overdue alerts, HTML formatting) |
| Ntfy.sh | Self-hosted or public topic URL + optional Bearer access token |
| Gotify | Server URL + Application Token |
| Webhook (Discord / Slack / Generic) | Automatically formats rich embeds for Discord/Slack or dispatches a structured JSON payload |
| Sent through Microsoft 365 (sign in), Gmail (connect with Google), SMTP or Microsoft Graph with your own app. |
By default, every registered user has a strictly isolated garage: User A cannot see User B's vehicles.
Want to share a family car with your partner, parents, or co-driver?
- Go to My Garage (
Mijn Garage) and click the Share (Delen) button on any vehicle you own. - Select or enter the email address of a registered user and choose their access level:
-
Editor (Bewerker): Can view and log fuel fill-ups, maintenance records, documents, tire measurements, trips, fixed expenses, and view TCO analytics. Only the owner can delete the vehicle itself. -
Viewer (Kijker): Read-only access to the vehicle's dashboard, fuel history, maintenance history, documents, tires, and TCO analytics.
-
- Shared vehicles display a
Gedeeld door ...(Shared by) badge in the recipient's garage.
-
admin: Full system access, AI/Notification/Backup settings, and user management. -
user: Full VehicleVault interface for their own vehicles and any vehicles shared with them. -
driver(Chauffeur Modus): Simplified, high-contrast mobile dashboard focused on 1-click fueling, EV charging, and trip logging.
VehicleVault integrates seamlessly behind authentication reverse proxies:
- Supported Proxies: Pangolin, Authelia, Authentik, Traefik Forward-Auth, and Cloudflare Access.
-
Supported Headers:
Remote-Email,X-Forwarded-Email,Remote-User,X-Forwarded-User, orX-Pangolin-User. - Admin UI Toggle: Under Settings β Gebruikers & Toegang, administrators can toggle Reverse Proxy SSO on or off at any time. When disabled, proxy headers are safely ignored.
-
Strict IP Validation: VehicleVault validates that incoming requests containing proxy headers originate from trusted loopback (
127.0.0.1,::1) or standard RFC 1918 private subnets (10.0.0.0/8,172.16.0.0/12,192.168.0.0/16). Public clients cannot inject spoofed headers. - Auto-Provisioning: When a user logs in through Pangolin or Authentik for the first time, a corresponding VehicleVault account is automatically provisioned for them.
Want friends, prospective users, or community visitors to test VehicleVault without having to manually invite them or give them access through your SSO/reverse proxy?
- 1-Click Guest Trial: Click Probeer Proefmodus (1-Click) on the login screen to enter a fully functional, isolated sandbox session immediately.
-
Invite Link Auto-Entry: Direct visitors to
https://your-domain.com/?guest=1or?proef=1to launch directly into the guest trial without touching the login form. - Persistent Trial Banner: A floating reminder banner indicates that the session is in guest mode and provides a Bewaar Mijn Account (Convert) button.
- Seamless Account Conversion: At any moment, the guest can enter their email and choose a password. Their guest account is instantly converted into a permanent account with all their test vehicles, fuel entries, and maintenance history preserved.
-
Admin Access Control: Administrators can enable or disable guest access under Settings β Gebruikers & Toegang or via the
ALLOW_GUEST_ACCESS=falseenvironment variable.
Passkeys let you sign in with a fingerprint, face or device PIN instead of typing a password. They work next to the password, which stays available as the fallback.
- A domain name and HTTPS (or
localhost). - Behind a reverse proxy, set
RP_IDandRP_ORIGINS:RP_ID=vault.yourdomain.com RP_ORIGINS=https://vault.yourdomain.com
- Your first passkey comes with 8 one-time recovery codes. They are stored only as SHA-256 hashes and are consumed on use.
-
Zero-Flash System Theme: Automatically detects the visitor's operating system and browser preference (
prefers-color-scheme). Dark mode or light mode is activated instantly before page render. -
Automatic Language Detection: Inspects
navigator.languageandnavigator.languages. Dutch-speaking users are automatically greeted in Nederlands (nl), while international visitors receive the interface in English (en). -
Manual Override: The user's explicit choices via the theme switcher and language flag toggle are persistently remembered in
localStorage.
VehicleVault v3.2.0 β Self-Hosted Vehicle Management, AI Invoice Translator, TCO & Model Context Protocol β’ GitHub Repository
- π Home
- π³ Installation & Docker
- π€ AI Receipt & Invoice Scanner
- π οΈ Maintenance, TCO & PDF Export
- π Tires & Trip Logging
- π Home Assistant, .ics & MCP
- π Notifications, Sharing & Security