ddeb64cef5
📦 chore(setup.sh): add setup script to install pre-commit and configure it 📄 docs(README.md): update repository name and add description of custom Home Assistant addons 📄 docs(kresus/DOCS.md): add documentation for Kresus addon 🐳 feat(kresus): add Dockerfile and build.yaml for Kresus addon 🔧 chore(kresus): add configuration files for Kresus addon 🔧 chore(kresus): add apparmor profile for Kresus addon 🔧 chore(kresus): add changelog and docs for Kresus addon 🔧 chore(kresus): add icon and logo for Kresus addon 🔧 chore(kresus): add license file for Kresus addon 🔧 chore(kresus): add README and requirements file for Kresus addon 🔧 chore(kresus): add service scripts for Kresus addon 🔧 chore(kresus): add translations for Kresus addon 🔧 chore(repository.yaml): add repository information for MrRaph_'s custom Home Assistant addons
1.9 KiB
Home Assistant Custom Add-on: Kresus
Kresus is an open-source self-hostable Personal Finance Manager. It automatically retrieves your daily bank transactions, lets you categorize them and manage your monthly budgets.
It relies on woob to fetch data from your bank website.
Installation
Kresus requires a PostgreSQL database to store data. If you do not already have a PostgreSQL database installed, you may consider the PostgreSQL addon.
The installation of Kresus add-on is quite straightforward and do not differ from the standard installation process for Home-Assistant add-ons:
-
Click the Home Assistant My button below to open the add-on on your Home Assistant instance.
[![Open this add-on in your Home Assistant instance.][addon-badge]][addon]
-
Click the "Install" button to install the add-on.
-
Start the "Kresus" add-on.
-
Check the logs of the "Kresus" add-on to see if everything went well. A working installation should indicate
Server is ready, let's start the show! -
Click the "OPEN WEB UI" button to open Kresus UI.
Configuration
The only configuration configurations required are the database connection options. If you used the PostgreSQL add-on configured with following options:
databases:
- kresus_db
logins:
- password: CHANGEME_kr3sus-p@ssword_CHANGEME
username: kresus_user
rights:
- database: kresus_db
username: kresus_user
then you may configure kresus with these options:
postgres_hostname: homeassistant.local
postgres_port: 5432
postgres_user: kresus_user
postgres_password: CHANGEME_kr3sus-p@ssword_CHANGEME
postgres_database: kresus_db
Authors & contributors
The original setup of this repository is by Ezlo Picori.