MotoMate

Take control of your vehicle maintenance with MotoMate, a self-hosted (maintenance) tracking web application. Access your digital maintenance journal from any mobile device to log tasks right from the garage. Because it is self-hosted, your data and service history never leave your own hardware.

View our demo-instance here (hosted by MijnMotorParkeren.nl). Want to try it yourself? Then set-up your own instance using the instructions below.

Warning

We need your help! MotoMate is still under active development and you may encounter bugs. Please help improve the project by reporting issues, suggesting missing features, or, preferably, submitting a pull request.

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:

# You need to generate a random AUTH_SECRET first:
echo "AUTH_SECRET=$(openssl rand -hex 32)" > .env

Then save the following contents into your docker-compose.yml file:

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_SECRET=${AUTH_SECRET}
      - AUTH_ALLOW_REGISTRATION=false
      - AUTH_COOKIE_SECURE=false
    restart: unless-stopped

After downloading the image and starting the container, the application will be ready in a few seconds once database migrations complete.

Integrations

MotoMate exposes a complete OpenAPI interface for custom API integrations. It supports configurable notification handlers for alerts and it connects directly with S3-compatible object storage and Paperless-ngx for automated document backups.

Donate

Want to support MotoMate? Drop a star on GitHub, or consider supporting development via GitHub Sponsors or Buy Me a Coffee.

License

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

Contributors

Made possible thanks to the following people:

Dan 💻 🤔

Michael Varrieur 💻

Ovidiu 🌍

Ovidiu Curcan 💻

Jason Mitchell 💻

NJBodey 💻

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