📦 chore(kresus): add Kresus addon files and configuration
✨ feat(kresus): add Dockerfile and build.yaml for building Kresus addon image ✨ feat(kresus): add config.yaml for Kresus addon configuration ✨ feat(kresus): add icon.png and logo.png for Kresus addon branding ✨ feat(kresus): add rootfs directory with necessary files for Kresus addon ✨ feat(kresus): add translations/en.yaml for English translations of Kresus addon 🐛 fix(kresus): fix finish script to handle service failure and restart 🐛 fix(kresus): fix run script to initialize data directory and generate Kresus salt 🔧 chore(kresus): update woob dependencies install method in Dockerfile 🔧 chore(kresus): update Kresus version to 0.6.2 in CHANGELOG.md 🔧 chore(kresus): update Kresus dependencies in DOCS.md 🔧 chore(kresus): update Kresus dependencies in README.md 🔧 chore(kresus): update Kresus dependencies in apparmor.txt 🔧 chore(kresus): update Kresus dependencies in requirements.txt 🔧 chore(kresus): update Kresus dependencies in start.sh 🔧 chore(kresus): update Kresus dependencies in translations/en.yaml 🔧 chore(kresus): update Kresus dependencies in build.yaml 🔧 chore(kresus): update Kresus dependencies in config.yaml 🔧 chore(kresus): update Kresus dependencies in icon.png 🔧 chore(kresus): update Kresus dependencies in logo.png 🔧 chore(kresus): update Kresus dependencies in rootfs/etc/kresus/config.ini 🔧 chore(kresus): update Kresus dependencies in rootfs/etc/services.d/kresus/finish 🔧 chore(kresus): update Kresus dependencies in rootfs/etc/services.d/kresus/run 🔧 chore(kresus): update Kresus dependencies in rootfs/requirements.txt 🔧 chore(kresus): update Kresus dependencies in rootfs/usr/libexec/kresus/start.sh 🔧 chore(kresus): update Kresus
This commit is contained in:
54
kresus-mrraph/DOCS.md
Normal file
54
kresus-mrraph/DOCS.md
Normal file
@@ -0,0 +1,54 @@
|
||||
# Home Assistant Custom Add-on: Kresus
|
||||
|
||||
[Kresus](https://kresus.org/) 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](https://gitlab.com/woob/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](https://github.com/ezlo-picori/hassio-addons/tree/main/postgres).
|
||||
|
||||
The installation of Kresus add-on is quite straightforward and do not differ from the standard installation process for Home-Assistant add-ons:
|
||||
|
||||
1. 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]
|
||||
|
||||
1. Click the "Install" button to install the add-on.
|
||||
1. Start the "Kresus" add-on.
|
||||
1. 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!`
|
||||
1. 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](https://github.com/ezlo-picori/hassio-addons/tree/main/postgres) configured with following options:
|
||||
|
||||
```yaml
|
||||
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:
|
||||
|
||||
```yaml
|
||||
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](https://github.com/ezlo-picori).
|
||||
Reference in New Issue
Block a user