HELLEDGER

HELLEDGER

Docker app from Kreuzbube88's Repository

Overview

HELLEDGER is a self-hosted, privacy-first household finance tracker. All data stays on your server in a local SQLite database — no cloud, no subscriptions.

Transactions & Accounts
Transactions — Manual income, expense, and transfer entries with category and account assignment
Accounts — Multiple bank accounts per household with roles: Main, Fixed Costs, Variable, Savings, Separate
Categories — Income, fixed cost, and variable expense categories with subcategories and color coding
CSV / OFX / QFX Import — Bulk transaction import with column mapping and duplicate detection
Global Search — Full-text search across all transactions

Budget & Planning
Fixed Costs — Recurring income, expenses, and savings transfers with configurable intervals; auto-booking each month; reserve tracking
Forecast — 12-month projection based on fixed costs with cumulative savings balance
Savings Goals — Target amount and date, linked savings account, progress tracking

Loans
Loan Management — Consumer loans and mortgages with full amortization schedules
Extra Payments — One-time and recurring extra payments; term-shortening or payment-reduction effect
Loan KPIs — Interest saved, months saved, current balance, payoff date; CSV export

Reporting & Overview
Dashboard — Monthly KPIs, account balances by role, expense donut chart, savings goals widget
Month View — Detailed monthly breakdown by category with KPI bar and available balance split
Year View — Full-year category x month grid with totals
Reports — Expense by category, stacked monthly trend chart, balance history

Infrastructure
Backups — Scheduled and manual backups with configurable retention
Admin Panel — SMTP, OIDC (Authentik, Keycloak), user management, registration control
Multi-Household — Separate financial spaces; users can belong to multiple households
PWA — Installable on desktop and mobile, works offline
i18n — German (default) and English, per-user language preference
Dark/Light Mode — Manual toggle

Documentation: https://github.com/Kreuzbube88/helledger/tree/main/docs

Runtime arguments

Web UI
http://[IP]:[PORT:3000]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Web UI PortPorttcp

Port for the HELLEDGER web interface

Target
3000
Default
3000
Value
3000
DataPathrw

Database and persistent configuration storage

Target
/data
Default
/mnt/user/appdata/helledger
Value
/mnt/user/appdata/helledger
BackupsPathrw

Backup storage path

Target
/backups
Default
/mnt/user/appdata/helledger/backups
Value
/mnt/user/appdata/helledger/backups
PUIDVariable

User ID the app runs as (Unraid default: 99)

Default
99
Value
99
PGIDVariable

Group ID the app runs as (Unraid default: 100)

Default
100
Value
100
SECRET_KEYVariable

Required: random secret for session encryption. Generate with: openssl rand -hex 32

TZVariable

Container timezone

Default
Europe/Berlin
Value
Europe/Berlin
DEFAULT_LANGUAGEVariable

Default UI language (de or en)

Default
de
Value
de
DATABASE_PATHVariable

Path to SQLite database file inside the container

Default
/data/helledger.db
Value
/data/helledger.db
BACKUP_INTERVAL_HOURSVariable

Hours between automatic backups (0 to disable)

Default
24
Value
24
ALLOW_REGISTRATIONVariable

Allow new user self-registration

Default
true
Value
true

Details

Repository
ghcr.io/kreuzbube88/helledger:latest
Last Updated2026-05-31
First Seen2026-04-23

Run HELLEDGER on Unraid.

HELLEDGER is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.