selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
may logo

Self-host may

v0.44.2

Vehicle management dashboard for fuel, expenses, maintenance

BetaOpen SourceMIT
Updated11 hours ago
LanguagePython
Setup difficultyEasy
MobilePWA
ThemeDark mode
Stars
268
Port
5050 (HTTP web interface)
Docker
ghcr.io/dannymcc/may
Install with Docker
Dashboard overview showing vehicle statistics and recent activityVehicle list view with make, model, and fuel typeVehicle detail page showing specifications, fuel logs, and expensesIntegrations settings page for notifications, Home Assistant, and UK servicesImport/export interface for backups and data migration

What is may?

May is a self-hosted vehicle management application built with Flask that helps individuals and families track fuel consumption, expenses, maintenance schedules, reminders, and documents across multiple vehicles. It supports multi-user access with role-based permissions (Editor, Contributor, Viewer), dual-fuel vehicles, EV charging logs, tire set tracking, and recurring expenses. The application provides a REST API for automation, Home Assistant integration, calendar subscriptions for reminders, and UK-specific integrations for DVLA MOT/tax lookups and live fuel prices. It runs via Docker, Docker Compose, or manual Python installation, using SQLite by default with optional PostgreSQL support. The UI includes dark mode, internationalization (20+ languages), custom branding, and PWA support for mobile installation.

Should you self-host may?

may scores 48/100 on selfhost.directory (how scoring works) and ranks #10 of 15 in Home Management. It has 268 GitHub stars.

It shipped 20 stable releases in the past year. The latest, v0.44.2, came out on 12 September 2026. New versions land roughly every 1 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is yuvomi (76/100, 2 072 stars). It scores higher overall, so compare the two before you pick. See may vs yuvomi side by side.

Features

  • Analytics Dashboard
  • Attachment support
  • Document Storage
  • Expense Tracking
  • Fuel Logging
  • Maintenance Schedules
  • Multi-channel notifications
  • Multi-user with roles
  • Multi-Vehicle Support
  • PDF Reports
  • Quick entry mode
  • Recurring Expenses
  • Reminders
  • Tire set tracking
  • Trip logging

may README

How to install may

Install may with Docker

Docker Engine
Environment variables
SECRET_KEY, PUID, PGID, ADMIN_PASSWORD, DATABASE_URL, UPLOAD_FOLDER

docker run -d
--name may
-p 5050:5050
-v may_data:/app/data
-e SECRET_KEY=your-secret-key
-e PUID=1000
-e PGID=1000
ghcr.io/dannymcc/may:latest

Access the application at http://localhost:5050. First-time login: Username: admin, Password: Check container logs for auto-generated password.

How to configure may

  • ADMIN_PASSWORDFixed admin password (default is auto-generated and shown in logs)

    Fixed admin password (default is auto-generated and shown in logs)

  • DATABASE_URLsqlite:////app/data/may.dbDatabase connection string (SQLite or PostgreSQL)

    Database connection string (SQLite or PostgreSQL)

    values: sqlite:///path or postgresql://user:password@host:5432/may

  • HTMX_CDN_URLhttps://unpkg.com/htmx.org@1.9.10HTMX CDN URL

    HTMX CDN URL

  • PGID1000Group ID the container runs as (linuxserver.io convention)

    Group ID the container runs as (linuxserver.io convention)

  • PUID1000User ID the container runs as (linuxserver.io convention)

    User ID the container runs as (linuxserver.io convention)

  • SECRET_KEYGenerated on first start and saved to data/.secret_keySession encryption key

    Session encryption key

  • TAILWIND_ASSET_URL/static/vendor/tailwindcss.jsLocal Tailwind Play CDN JS path

    Local Tailwind Play CDN JS path

  • TAILWIND_CDN_URLhttps://cdn.tailwindcss.comTailwind CDN fallback URL

    Tailwind CDN fallback URL

  • UPLOAD_FOLDERdata/uploads inside the application directoryPath for file uploads

    Path for file uploads

may releases & version history

More in Home Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…