colfin22/car-costs repository overview

⁠Car Costs

A tiny self-hosted tracker for what your cars actually cost — built to be used one-handed at the pump.

Open it, tap a car, add the entry. That's the entire workflow.

• Log in seconds — a fill is amount + odometer; tax, insurance, NCT and servicing are dated amounts, freely backdatable
• See what it really costs — year total by category, cost per km, L/100km, per car
• Never miss a date — badges and banners from 14 days out, plus phone reminders through Home Assistant
• Full lifecycle tracking — service history with km/months intervals, timing belt deadlines, per-corner tyre records
• Installable PWA, FastAPI + SQLite, daily automatic backups

Irish-focused: NCT, motor tax, euro, kilometres.

⁠Quick start

  docker run -d -p 8000:8000 -v carcosts-data:/srv/data \
    --restart unless-stopped colfin22/car-costs:latest

Then open http://localhost:8000⁠ — one placeholder car is seeded on first run; rename it via Edit and start logging. The database, photos and daily backups all live under /srv/data, so that one volume is everything worth keeping.

⁠Tags

• latest — most recent release
• X.Y.Z / X.Y — pinned versions
• Multi-arch: linux/amd64 and linux/arm64

⁠Links

• Source, full docs & screenshots⁠
• Issues⁠

MIT licensed — built by Colm Finn.