Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mayswind/ezbookkeeping

A lightweight personal bookkeeping app hosted by yourself.
https://github.com/mayswind/ezbookkeeping

account-book accounting app bookkeeping financial golang javascript mobile money money-management money-manager personal personal-finance self-hosted vue

Last synced: about 20 hours ago
JSON representation

A lightweight personal bookkeeping app hosted by yourself.

Host: GitHub
URL: https://github.com/mayswind/ezbookkeeping
Owner: mayswind
License: mit
Created: 2020-10-17T08:54:02.000Z (over 4 years ago)
Default Branch: main
Last Pushed: 2025-02-13T16:20:47.000Z (1 day ago)
Last Synced: 2025-02-13T17:28:55.097Z (1 day ago)
Topics: account-book, accounting, app, bookkeeping, financial, golang, javascript, mobile, money, money-management, money-manager, personal, personal-finance, self-hosted, vue
Language: Go
Homepage: https://ezbookkeeping.mayswind.net
Size: 9.34 MB
Stars: 329
Watchers: 8
Forks: 52
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # ezBookkeeping

[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/mayswind/ezbookkeeping/blob/master/LICENSE)

[![Latest Build](https://img.shields.io/github/actions/workflow/status/mayswind/ezbookkeeping/docker-snapshot.yml?branch=main)](https://github.com/mayswind/ezbookkeeping/actions)

[![Go Report](https://goreportcard.com/badge/github.com/mayswind/ezbookkeeping)](https://goreportcard.com/report/github.com/mayswind/ezbookkeeping)

[![Latest Docker Image Size](https://img.shields.io/docker/image-size/mayswind/ezbookkeeping.svg?style=flat)](https://hub.docker.com/r/mayswind/ezbookkeeping)

[![Latest Release](https://img.shields.io/github/release/mayswind/ezbookkeeping.svg?style=flat)](https://github.com/mayswind/ezbookkeeping/releases)

## Introduction

ezBookkeeping is a lightweight personal bookkeeping app hosted by yourself. It can be deployed on almost all platforms, including Windows, macOS and Linux on x86, amd64 and ARM architectures. You can even deploy it on an raspberry device. It also supports many different databases, including sqlite and mysql. With docker, you can just deploy it via one command without complicated configuration.

Online Demo: [https://ezbookkeeping-demo.mayswind.net](https://ezbookkeeping-demo.mayswind.net)

## Features

1. Open source & Self-hosted

2. Lightweight & Fast

3. Easy to install

    * Docker support

    * Multiple database support (SQLite, MySQL, PostgreSQL, etc.)

    * Multiple operation system & hardware support (Windows, macOS, Linux & x86, amd64, ARM)

4. User-friendly interface

    * Both desktop and mobile UI

    * Close to native app experience (for mobile device)

    * Two-level account & two-level category support

    * Plentiful preset categories

    * Geographic location and map support

    * Searching & filtering history records

    * Data statistics

    * Dark theme

5. Multiple currency support & automatically updating exchange rates

6. Multiple timezone support

7. Multi-language support

8. Two-factor authentication

9. Application lock (PIN code / WebAuthn)

10. Data import & export (OFX, QFX, QIF, IIF, GnuCash, FireFly III, etc.)

## Screenshots

### Desktop Version

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

### Mobile Version

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

## Installation

### Ship with docker

Visit [Docker Hub](https://hub.docker.com/r/mayswind/ezbookkeeping) 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

Latest release: [https://github.com/mayswind/ezbookkeeping/releases](https://github.com/mayswind/ezbookkeeping/releases)

**Linux / macOS**

    $ ./ezbookkeeping server run

**Windows**

    > .\ezbookkeeping.exe server run

ezBookkeeping will listen at port 8080 as default. Then you can visit `http://{YOUR_HOST_ADDRESS}:8080/` .

### Build from source

Make sure you have [Golang](https://golang.org/), [GCC](http://gcc.gnu.org/), [Node.js](https://nodejs.org/) and [NPM](https://www.npmjs.com/) 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 docker image, make sure you have [docker](https://www.docker.com/) installed, then follow these steps:

**Linux**

    $ ./build.sh docker

## Documents

1. [English](http://ezbookkeeping.mayswind.net)

1. [简体中文 (Simplified Chinese)](http://ezbookkeeping.mayswind.net/zh_Hans)

## License

[MIT](https://github.com/mayswind/ezbookkeeping/blob/master/LICENSE)