mayswind/ezbookkeeping

Introduction

ezBookkeeping is a lightweight, self-hosted personal finance app with a user-friendly interface and powerful bookkeeping features. It helps you record daily transactions, import data from various sources, and quickly search and filter your bills. You can analyze historical data using built-in charts or perform custom queries with your own chart dimensions to better understand spending patterns and financial trends. ezBookkeeping is easy to deploy, and you can start it with just one single Docker command. Designed to be resource-efficient, it runs smoothly on devices such as Raspberry Pi, NAS, and MicroServers.

ezBookkeeping offers tailored interfaces for both mobile and desktop devices. With support for PWA (Progressive Web Apps), you can even https://raw.githubusercontent.com/wiki/mayswind/ezbookkeeping/img/mobile/add_to_home_screen.gif and use it like a native app.

GitHub: https://github.com/mayswind/ezbookkeeping
Live Demo: [***]

Run with Docker

Latest Release:

$ docker run -p8080:8080 mayswind/ezbookkeeping

Latest Daily Build:

$ docker run -p8080:8080 mayswind/ezbookkeeping:latest-snapshot

Stable Release Tags

• v1.4.x: 1.4.0
• v1.3.x: 1.3.2, 1.3.1, 1.3.0
• v1.2.x: 1.2.0
• v1.1.x: 1.1.1, 1.1.0
• v1.0.x: 1.0.1, 1.0.0
• v0.10.x: 0.10.0
• v0.9.x: 0.9.0
• v0.8.x: 0.8.0
• v0.7.x: 0.7.0
• v0.6.x: 0.6.0
• v0.5.x: 0.5.0
• v0.4.x: 0.4.1, 0.4.0
• v0.3.x: 0.3.0
• v0.2.x: 0.2.0
• v0.1.x: 0.1.0

Screenshots

Desktop Version

https://raw.githubusercontent.com/wiki/mayswind/ezbookkeeping/img/desktop/en.png](https://raw.githubusercontent.com/wiki/mayswind/ezbookkeeping/img/desktop/en.png)

Mobile Version

https://raw.githubusercontent.com/wiki/mayswind/ezbookkeeping/img/mobile/en.png](https://raw.githubusercontent.com/wiki/mayswind/ezbookkeeping/img/mobile/en.png)

Features

• Open Source & Self-Hosted
  • Built for privacy and control
• Lightweight & Fast
  • Minimal resource usage, runs smoothly even on low-resource devices
• Easy Installation
  • Docker support
  • Supports SQLite, MySQL, PostgreSQL
  • Cross-platform (Windows, macOS, Linux)
  • Works on x86, amd64, ARM architectures
• User-Friendly Interface
  • UI optimized for both mobile and desktop
  • PWA support for native-like mobile experience
  • Dark mode
• AI-Powered Features
  • Receipt image recognition
  • MCP (Model Context Protocol) support for AI integration
  • Agent Skill and API command-line script tools support for AI integration
• Powerful Bookkeeping
  • Two-level accounts and categories
  • Image attachments for transactions
  • Location tracking with maps
  • Scheduled transactions
  • Advanced filtering, search, visualization and analysis
• Localization & Internationalization
  • Multi-language and multi-currency support
  • Multiple exchange rate sources with automatic updates
  • Multi-timezone support
  • Custom formats for dates, numbers and currencies
• Security
  • Two-factor authentication (2FA)
  • OIDC external authentication
  • Login rate limiting
  • Application lock (PIN code / WebAuthn)
• Data Import & Export
  • Supports CSV, OFX, QFX, QIF, IIF, Camt.052, Camt.053, MT940, GnuCash, Firefly III, Beancount and more

For a full list of features, visit the Full Feature List.

Documentation

1. English
2. 中文 (简体)

License

https://github.com/mayswind/ezbookkeeping/blob/master/LICENSE