MotoMate

MotoMate is a self-hosted maintenance tracker for vehicles. Manage your own maintenance journals easily, in a web interface available from your (mobile) device. You can log custom maintenance tasks directly from the garage. All service history and data remain strictly on your own hardware.

Warning

MotoMate is still in development. You may encounter bugs, feel free to help improve the project by reporting any issues you find.

We want to make it incredibly simple for riders and vehicle enthusiasts to host their own maintenance journals. Unlike more complex systems such as LubeLogger, MotoMate is designed to strip your tracking down to the absolute essentials.

Getting Started

You can run MotoMate locally using Docker Compose:

services:
  motomate:
    image: ghcr.io/hawkinslabdev/motomate:latest
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
      - ./uploads:/app/uploads
    environment:
      - TZ=Europe/Amsterdam
      - PUBLIC_APP_URL=http://localhost:3000
      - PUBLIC_APP_ORIGINS=http://localhost
      - AUTH_COOKIE_SECURE=false
      - AUTH_SECRET=change-me-in-production-min-32-chars
      - STORAGE_ADAPTER=local
      - BODY_SIZE_LIMIT=20971520
    restart: unless-stopped

After downloading the image and starting the container, the application will be available after a few seconds. The production server applies pending database migrations before it starts listening; if migrations fail, MotoMate exits instead of serving traffic against an out-of-date schema.

Donate

If MotoMate replaces your existing spreadsheet or saves you time, you can support the project through GitHub Sponsors or Buy Me A Coffee.

License

This project is licensed under the AGPL 3.0 license. See LICENSE for details.

Contributing

Contributions including ideas, bug reports, and pull requests are welcome. Please open an issue to discuss any proposed changes or identified issues.