Overview of LubeLogger
mainLubeLogger is a self-hosted, open-source, web-based application designed for vehicle maintenance and fuel mileage tracking. It serves as an alternative to manual spreadsheets or paper receipt tracking.
LubeLogger Documentation
repository·main·Indexed 25 days ago
https://github.com/hargata/lubelogA self-hosted, open-source web application for tracking vehicle maintenance and fuel mileage. Features include fuel economy tracking in multiple units (MPG, L/100KM, KM/L), maintenance reminders based on odometer or date, CSV import/export with Fuelly support, and collaborator access for shared vehicles. Deployable via Docker, Windows standalone executable, or Kubernetes using Helm.
What's inside LubeLogger
Customize records with Custom Fields
mainLubeLog supports the use of Custom Fields to capture specific data points not covered by default fields.Add collaborators to a vehicle
mainLubeLog allows multiple people to collaborate on the same vehicle, enabling different users to add or edit records for a single vehicle entry.Import and export vehicle data via CSV
mainLubeLog supports importing and exporting data using CSV files. The import functionality specifically supports data formats from Fuelly.Configure maintenance reminders
mainSet reminders for vehicle maintenance based on:
- Odometer readings
- Specific dates
- A combination where the reminder triggers on whichever comes first.
Access LubeLogger Documentation and Troubleshooting
mainIf you encounter issues or need guidance, use the following resources:
- Official Documentation: https://docs.lubelogger.com/
- Troubleshooting Guide: https://docs.lubelogger.com/Installation/Troubleshooting
- GitHub Issues: Search existing issues on GitHub
Install LubeLogger via Docker or Windows
mainLubeLogger can be deployed using a Docker Image or as a Windows Standalone Executable. For detailed instructions on how to download and set up these versions, refer to the Getting Started Guide.Manage user registration via Admin Panel tokens
mainLubeLog uses a token-based registration system. Administrators can use the Admin Panel to generate tokens, which are then required by new users to sign up for the service.Deploy LubeLogger on Kubernetes using Helm
mainFor Kubernetes environments, LubeLogger can be deployed using a Helm Chart provided by Anza-Labs.
Track fuel economy and gas records
mainYou can track gas records using various measurement units, including:
- MPG (Miles Per Gallon)
- L/100KM (Liters per 100 Kilometers)
- KM/L (Kilometers per Liter)
- British use-case: Purchase gas in liters and calculate fuel economy in miles per UK Gallon (imp gal).
Deploy Lubelog using Docker Compose
mainTo run Lubelog as a containerized service, use the following
docker-compose.ymlconfiguration. This setup ensures data persistence for application data and ASP.NET Data Protection keys, and exposes the application on port 8080.Persistence Requirements:
/App/data: Stores application-specific data./root/.aspnet/DataProtection-Keys: Stores encryption keys used by ASP.NET for data protection.
Network Access:
- The service is accessible via port
8080on the host.
services: app: image: ghcr.io/hargata/lubelogger:latest restart: unless-stopped volumes: - data:/App/data - keys:/root/.aspnet/DataProtection-Keys ports: - 8080:8080 volumes: data: keys:Try the LubeLogger Live Demo
mainYou can test the application via the live demo before installing it. Note that the live demo environment resets every 20 minutes.
Demo Credentials:
- Username:
test - Password:
1234
- Username: