Skip to content

mayswind/ezbookkeeping

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ezBookkeeping

License Latest Build Go Report Latest Docker Image Size Latest Release

Introduction

ezBookkeeping is a lightweight, self-hosted personal finance app with a sleek, user-friendly interface and powerful bookkeeping features. Built with simplicity and portability in mind, it's easy to deploy, easy to use, and requires minimal system resources — perfect for microservers, NAS devices, and even Raspberry Pi.

The app is fully cross-platform and device-friendly — you can use it seamlessly on mobile, tablet, and desktop devices. With support for PWA (Progressive Web Apps), you can even add it to your mobile home screen and use it like a native app.

Live Demo: https://ezbookkeeping-demo.mayswind.net

Features

  • Open Source & Self-Hosted
    • Built for privacy and control
  • Lightweight & Fast
    • Optimized for performance, runs smoothly even on low-resource environments
  • Easy Installation
    • Docker-ready
    • 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
    • Supports MCP (Model Context Protocol) for AI integration
  • Powerful Bookkeeping
    • Two-level accounts and categories
    • Attach images to transactions
    • Location tracking with maps
    • Recurring transactions
    • Advanced filtering, search, visualization, and analysis
  • Localization & Globalization
    • Multi-language and multi-currency support
    • Automatic exchange rates
    • Multi-timezone awareness
    • Custom formats for dates, numbers, and currencies
  • Security
    • Two-factor authentication (2FA)
    • Login rate limiting
    • Application lock (PIN code / WebAuthn)
  • Data Import/Export
    • Supports CSV, OFX, QFX, QIF, IIF, Camt.053, MT940, GnuCash, Firefly III, Beancount, and more

Screenshots

Desktop Version

ezBookkeeping

Mobile Version

ezBookkeeping

Installation

Run with Docker

Visit Docker Hub to see all images and tags.

Latest Release:

$ docker run -p8080:8080 mayswind/ezbookkeeping

Latest Daily Build:

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

Install from Binary

Download the latest release: https://github.com/mayswind/ezbookkeeping/releases

Linux / macOS

$ ./ezbookkeeping server run

Windows

> .\ezbookkeeping.exe server run

By default, ezBookkeeping listens on port 8080. You can then visit http://{YOUR_HOST_ADDRESS}:8080/ .

Build from Source

Make sure you have Golang, GCC, Node.js and NPM installed. Then download the source code, and follow these steps:

Linux / macOS

$ ./build.sh package -o ezbookkeeping.tar.gz

All the files will be packaged in ezbookkeeping.tar.gz.

Windows

> .\build.bat package -o ezbookkeeping.zip

All the files will be packaged in ezbookkeeping.zip.

You can also build a Docker image. Make sure you have Docker installed, then follow these steps:

Linux

$ ./build.sh docker

Contributing

We welcome contributions of all kinds!

Found a bug? Submit an issue

Want to contribute code? Feel free to fork and send a pull request.

Contributions of all kinds — bug reports, feature suggestions, documentation improvements, or code — are highly appreciated.

Check out our Contributor Graph to see the amazing people who’ve already helped.

Translating

Help make ezBookkeeping accessible to users around the world! If you want to contribute a translation, please refer to our translation guide.

Currently available translations:

Tag Language Contributors
de Deutsch @chrgm
en English /
es Español @Miguelonlonlon
it Italiano @waron97
ja 日本語 @tkymmm
pt-BR Português (Brasil) @thecodergus
ru Русский @artegoser
uk Українська @nktlitvinenko
vi Tiếng Việt @f97
zh-Hans 中文 (简体) /
zh-Hant 中文 (繁體) /

Don't see your language? Help us add it!

Documentation

  1. English
  2. 中文 (简体)

License

MIT