tgrosinger/metaledger
Archived
1
0
Fork 0
Code
A collection of tools for Ledger, grouped into an easy to use Docker Compose script.
This repository has been archived on 2023-12-27. You can view files and clone it, but cannot push or open issues or pull requests.
32 Commits 1 Branch 0 Tags 97 KiB
Shell 100%
main
Go to file
Tony Grosinger 2327851100 Add description to readme
2022-07-27 09:23:19 -07:00
bin Add description to readme 2022-07-27 09:23:19 -07:00
config Add metabase and improve configuration 2022-07-24 09:04:15 -07:00
data Create docker-compose to run ledger utilities 2022-07-19 10:39:42 -07:00
ledgerbil@02dd7a8438 Create docker-compose to run ledger utilities 2022-07-19 10:39:42 -07:00
.env Add reconcile command helper 2022-07-26 21:55:57 -07:00
.gitattributes Add hledger aarch64 build 2022-07-21 15:29:58 -07:00
.gitignore Add metabase and improve configuration 2022-07-24 09:04:15 -07:00
.gitmodules Create docker-compose to run ledger utilities 2022-07-19 10:39:42 -07:00
docker-compose.yaml Convert from metabase to superset 2022-07-26 16:26:57 -07:00
README.md Add description to readme 2022-07-27 09:23:19 -07:00

README.md

MetaLedger

MetaLedger makes it easy to setup plain text accounting by configuring several useful utilities and grouping them into a single Docker Compose script.

  • hledger for command line interaction and ledger file parsing
  • ledgerbil for interactive reconciliation
  • Apache Superset for awesome custom dashboarding
    • Uses a utility to automatically periodically dump your ledger data into a SQLite database that Superset can query.

Currently it can be run on linux/amd64 and linux/arm64 (except for superset due to this issue). Adding more platforms should be possible, they just need to be added to the underlying hledger-multiarch project.

hledger exposes a web interface (configure the port in the .env file). There are also utility script in the bin directory to make regular tasks quick and easy.

Setting Up

  • Initialize the submodules

    git submodule init
git submodule update

  • Put your ledger files in the data folder.

  • Edit .env and fill in your desired values.

  • Copy ledgerbil/ledgerbil/settings.py.example to ledgerbil-settings.py and fill in the values with your data.

  • Start the services with docker-compose up -d

You can now access the web UI for hledger at your chosen URL (from the .env file), ledger-analytics, and use the helper scripts in the bin directory to use the various utilities. All utilities should be pre-configured with your ledger file location.

Usage

If you add the bin directory to your path, the utility scripts in there will expose various ledger and hledger functionality by mapping into the respective containers. They will be automatically configured to interact with your ledger files as defined in the .env file.