https://github.com/domnikl/bookkeeping
Bookkeeping for personal finance
https://github.com/domnikl/bookkeeping
bookkeeping fints
Last synced: 7 months ago
JSON representation
Bookkeeping for personal finance
- Host: GitHub
- URL: https://github.com/domnikl/bookkeeping
- Owner: domnikl
- License: apache-2.0
- Created: 2022-11-24T21:43:29.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-20T21:13:24.000Z (7 months ago)
- Last Synced: 2025-07-26T15:38:57.501Z (7 months ago)
- Topics: bookkeeping, fints
- Language: TypeScript
- Homepage:
- Size: 1.98 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bookkeeping
Bookkeeping is a highly opinionated private household management tool.
It uses Postgres as a storage backend and FinTS to synchronize bank account balances and transactions as well as Auth0 to handle sign ins and auth.
## Refresh access to FinTS
Depending on your bank, refreshing access sometimes require to login into another app they provide and run `node ace fints` afterward to resync.
Integration may not work with every bank, you may need to tweak settings as FinTS is a rather obscure protocol.
Please have a look at the [fints](https://github.com/domnikl/fints) fork.
## Building it
```sh
npm run build
```
and deploy the build folder to your production environment and run `node ace migration:run` followed by `node server.js` from it.
## Docker
```sh
docker build -t domnikl/bookkeeping . --network host
```
Fetching balances and transactions from FinTS will run on a schedule, but if you need to do it manually, run the following command:
```sh
node ace fints
```
## Development
```sh
docker-compose up -d # to start local DB server
npm run dev
```