Glovebox

Glovebox

Docker app from matthewjackson446's Repository

Glovebox keeps track of your vehicles: MOT, road tax, insurance, servicing (by date or mileage), breakdown cover, warranty and finance, colour-coded by when they are due.

Overview
Glovebox keeps track of your vehicles: MOT, road tax, insurance, servicing (by date or mileage), breakdown cover, warranty and finance, colour-coded by when they are due. Get a daily reminder digest by email, ntfy, Gotify, Discord or webhook, or subscribe to a private calendar link. Keep service history, mileage and documents (V5C, certificates, receipts), renew policies with price history, and pull up a one-tap emergency card at the roadside. Optional DVLA and DVSA lookups (bring your own free keys) fill in vehicle details and keep tax and MOT dates current. Multi-user with per-vehicle sharing. Everything is stored in your appdata folder.

Glovebox

A self-hosted tracker for your vehicles: MOT, road tax, insurance, servicing, breakdown cover, warranty and finance, all in one place and colour-coded by when they're due.

Dashboard

  • Dashboard. A Needs attention list at the top gathers everything overdue (red) or due within 30 days (amber) across all your vehicles, with a one-tap Renew or Update button for each item. Below it, every vehicle at a glance.
  • Renewals and due dates. Store providers, policy and membership numbers, phone numbers, premiums and excesses alongside the dates. A progress bar shows how far through each policy, MOT year or service interval you are.
  • MOT advisories to-do list. Advisories from the last MOT become a checklist to tick off before the next one, with repeat advisories highlighted. They appear in your MOT reminders too. With DVSA keys they're filled in for you; without them, add them by hand.
  • Service by date or mileage. Update the mileage and service reminders work out the rest.
  • Calendar feed. A private link per user for Google, Apple or Outlook Calendar.
  • Reminders. A daily digest by email, ntfy, Gotify, Discord or webhook (e.g. Home Assistant). Each user picks when (60/30/14/7/3/1 days before, and when overdue) and where. You never get the same reminder twice, and renewing an item starts its reminders afresh.
  • Service history and documents. Log services, repairs and tyres with cost, garage and mileage. Upload PDFs and photos (V5C, certificates, receipts) and attach them to a renewal or a job. Mileage readings give an annual average and an estimated date for mileage-based services.
  • Running costs. A Costs page totals each year by vehicle and category (insurance, tax, servicing and repairs, breakdown, warranty, finance), built from what you already record.
  • Archive sold vehicles. They leave the dashboard, reminders and calendar but keep their history, costs and documents, and can be restored.
  • Renew with price history. Roll an insurance, breakdown, warranty or tax period on a year and see how the price compares with previous years.
  • Clean air zones and road tax band. See at a glance whether London's ULEZ and the UK's Clean Air and Low Emission Zones are likely to charge each vehicle, and which road tax band it's in. These are worked out from the fuel, first registration date, CO₂ and Euro status, with links to the official checkers and current GOV.UK rates.
  • DVLA and DVSA lookups (optional). Bring your own free keys to fill in vehicle details from the registration and refresh tax and MOT dates, SORN status and MOT history every night.
  • Emergency card that works with no signal. A one-tap page with your breakdown line, insurer's claims line, policy numbers, locking wheel nut code and emergency contacts. Add Glovebox to your phone's home screen and every vehicle's card is saved on the phone, so it still opens at the roadside with no signal (needs HTTPS; see below). Saved cards are wiped when you sign out.
  • Two-factor sign-in. Optional 6-digit codes from any authenticator app, with recovery codes. Recommended if your instance is on the internet.
  • Backup download. Admins can download a ZIP of the database and all documents from Settings → Server.
  • Light and dark mode. Follows your device, or pick one from the header.
  • Multi-user. The admin creates accounts. Each vehicle can be shared with other users as owner, can edit or can view.
  • One container, one SQLite file. All data lives in /config. Images are built for x86-64 and ARM64 (Raspberry Pi 4/5, Apple Silicon, ARM NAS boxes).
Vehicle Service history and documents
Vehicle page Service history, mileage and documents
Reminders Emergency card (phone)
Reminder settings Emergency card on a phone

MOT advisories

MOT advisories checklist

See CHANGELOG.md for what's in each release.

Running on Unraid

Until Glovebox is listed in Community Apps, install the template by hand:

  1. Open Unraid's terminal (the >_ icon) and save the template to your flash drive:
    wget -O /boot/config/plugins/dockerMan/templates-user/my-Glovebox.xml https://raw.githubusercontent.com/matthewjackson446/glovebox/main/unraid/glovebox.xml
    
  2. Go to Docker → Add Container, pick Glovebox from the Template list, check the port and appdata path, then click Apply.
  3. Open the WebUI and create the admin account.

Updating: when Unraid's Docker tab shows an update for Glovebox, click Apply Update. Your data in /config is kept and the database upgrades itself.

Docker / Compose

services:
  glovebox:
    image: ghcr.io/matthewjackson446/glovebox:latest
    ports: ["8080:8080"]
    environment:
      - PUID=99
      - PGID=100
      - TZ=Europe/London
    volumes:
      - /mnt/user/appdata/glovebox:/config
    restart: unless-stopped
Variable Default
PORT 8080 Port inside the container
PUID / PGID 99 / 100 User and group that own files in /config
UMASK 022
TZ Europe/London Decides what "today" is for due dates, and when the daily reminder run happens
GLOVEBOX_DISABLE_SCHEDULER unset Set to true to stop automatic daily reminders
SMTP_HOST, SMTP_PORT, SMTP_SECURITY, SMTP_USER, SMTP_PASS, SMTP_FROM unset Optional email settings. If SMTP_HOST is set, these take priority over Settings → Server and are shown read-only there. SMTP_SECURITY is starttls (default), tls or none.

Reverse proxy: Glovebox works on plain http://<lan-ip>:8080 and behind a reverse proxy over HTTPS. Pass X-Forwarded-Proto and X-Forwarded-Host through; Nginx Proxy Manager and SWAG do this by default. Cookies are only marked Secure when the request came in over HTTPS.

Using it on your phone: open Glovebox over HTTPS, then choose Add to Home Screen (Safari) or Install app (Chrome). Long-press the icon for a shortcut straight to your emergency cards. Browsers only allow offline use over HTTPS, so over plain http://<lan-ip> the emergency cards still work but need a connection.

Reminders: in Settings → Server, an admin sets the daily send time, an optional public URL (for links in notifications) and SMTP details if anyone wants email. Each user then adds their own channels under Settings → Reminders.

Calendar: each user can create a private subscription link under Settings → Calendar and add it to Google, Apple or Outlook Calendar. All due dates appear there and update by themselves. Set the Public URL first so the link works from outside your network. Anyone with the link can read the dates, so it can be reset or turned off at any time.

Vehicle lookups (optional): DVLA and DVSA

With your own free keys, typing a registration fills in the vehicle's details, and Glovebox refreshes tax and MOT dates, MOT history and mileage every night (just before reminders go out). Without keys, everything still works with dates entered by hand.

Glovebox doesn't ship with any keys. Each install uses keys issued to whoever runs it; they're stored only in that install's /config database. Never commit or share them.

DVLA Vehicle Enquiry Service: make, colour, fuel, engine, year, live tax status and due date, MOT expiry.

  1. Apply at register-for-ves.driver-vehicle-licensing.api.gov.uk (about the API).
  2. Describe personal use, e.g. "Self-hosted app to keep track of tax and MOT dates for my own household's vehicles", and choose the lowest monthly volume. Glovebox makes about one lookup per vehicle per day.
  3. DVLA emails you an API key, usually within a few working days.
  4. In Glovebox, open Settings → Server → Vehicle lookups, paste the key, save and press Test DVLA.

DVSA MOT History: every MOT test with result, mileage, advisories and failures, plus model and first MOT due date.

  1. Apply at documentation.history.mot.api.gov.uk/mot-history-api/register.
  2. DVSA emails you a client ID, client secret, API key, scope URL and token URL.
  3. Paste each into Settings → Server → Vehicle lookups (the scope is normally https://tapi.dvsa.gov.uk/.default, already filled in), save and press Test DVSA.
  4. Client secrets expire after 2 years; keys unused for 90 days are revoked. The nightly refresh keeps them in use.

Glovebox never overwrites details you've typed. It only fills blanks, keeps tax/MOT due dates current (turn this off per vehicle with Keep tax and MOT dates up to date automatically), and only ever moves mileage forwards.

Backups: an admin can download a ZIP from Settings → Server → Backup (restore steps are inside). Everything is also in /config: the database (glovebox.db) and uploaded files (documents/). Stop the container and copy the folder, or include it in your appdata backup.

Development

Requires Node 22. No Docker needed locally.

npm install
npm run dev        # http://localhost:5173, data in ./data
npm run check      # type-check

Testing the container on Unraid without building locally

docker context create unraid --docker "host=ssh://root@<unraid-ip>"
docker --context unraid compose up -d --build   # builds on Unraid, serves on :8090

Releasing

Pushing to main publishes ghcr.io/<owner>/glovebox:edge. Pushing a tag such as v0.1.0 publishes :0.1.0, :0.1 and :latest.

Roadmap

  • Vehicles, renewals and due dates, dashboard, emergency card, multi-user sharing
  • Reminders by email (SMTP), ntfy, Gotify and Discord/webhooks
  • Look up by registration via DVLA (tax and MOT dates) and DVSA (MOT history), with nightly refresh
  • Service history, mileage log, document uploads (V5C, certificates, receipts), renewals with price history
  • Calendar (.ics) feed
  • Community Apps listing

Licence

MIT

Categories

Related apps

Links

Details

Repository
ghcr.io/matthewjackson446/glovebox:latest
Last Updated2026-11-16
First Seen2026-11-15

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPorttcp

Port for the Glovebox web interface.

Target
8080
Default
8080
Value
8080
AppdataPathrw

Database and uploaded documents. Back this up.

Target
/config
Default
/mnt/user/appdata/glovebox
Value
/mnt/user/appdata/glovebox
TZVariable

Timezone, used for working out what's due today and when reminders are sent.

Default
Europe/London
Value
Europe/London
PUIDVariable

User ID to run as.

Default
99
Value
99
PGIDVariable

Group ID to run as.

Default
100
Value
100
SMTP serverVariable

Optional. Email settings can be entered here or in Glovebox under Settings, Server. If set here, they take priority and are locked in the app. e.g. smtp.gmail.com

Target
SMTP_HOST
SMTP portVariable

587 for STARTTLS, 465 for TLS.

Target
SMTP_PORT
Default
587
Value
587
SMTP securityVariable

starttls, tls or none.

Target
SMTP_SECURITY
Default
starttls
Value
starttls
SMTP usernameVariable
Target
SMTP_USER
SMTP passwordVariable

For Gmail, an app password.

Target
SMTP_PASS
SMTP from addressVariable

e.g. Glovebox glovebox@example.com

Target
SMTP_FROM
UMASKVariable

File permission mask for created files.

Default
022
Value
022