selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

家庭账房 · Family Ledger logo

Self-host 家庭账房 · Family Ledger

v1.37.0

Self-hosted family wealth tracker with real returns

ReleaseOpen SourceAGPL-3.0
Updated6 days ago
LanguageJava
Setup difficultyModerate
MobilePWA
Stars
372
CPU
1 core
RAM
1 GB
Storage
~2 GB
Port
20000 (HTTP application server)
Requires
MySQL 8
Docker
ghcr.io/luodi-nate/financial-management:latest
Install with Docker Compose
Dashboard showing net worth trend with CPI/M2 lines, asset allocation ring, KPI barsAsset checkup with four-dimension diagnosis and AI comprehensive diagnosisAsset lens with sunburst drill-down, cross-tab pivot, holding detail, 10 preset boardsAccount book with 10 account types grouped by member, transfer/checkup/ledger/exportMulti-dimensional tagging for accounts/holdings: asset type/platform/industry/purpose with AI suggestionsAI screenshot import recognizing each holding name+value with three-state diff confirmationMobile dashboard with insight overviewMobile monthly entry formMobile asset checkupMobile asset lens drill-down

What is 家庭账房 · Family Ledger?

Should you self-host 家庭账房 · Family Ledger?

家庭账房 · Family Ledger scores 52/100 on selfhost.directory (how scoring works) and ranks #24 of 62 in Personal Finance. It has 372 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v1.37.0, came out on 22 October 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Java.

Its closest alternative on selfhost.directory is Firefly III (82/100, 25 021 stars). It scores higher overall, so compare the two before you pick. See 家庭账房 · Family Ledger vs Firefly III side by side.

Features

  • True annualized returns (XIRR/TWR)

家庭账房 · Family Ledger README

How to install 家庭账房 · Family Ledger

Install 家庭账房 · Family Ledger with Docker Compose

Environment variables
DB_NAME, DB_USER, DB_PASS, MYSQL_ROOT_PASSWORD, MYSQL_IMAGE, SERVER_PORT, REMEMBER_ME_KEY, TZ, SEED_ADMIN_PASSWORD, FINANCE_KEEP_DEMO, RETENTION_DAYS, FUTU_ENABLED, FUTU_OPEND_IMAGE, FUTU_ALLOW_UNVERIFIED, FUTU_API_RSA

git clone https://github.com/LuoDi-Nate/financial-management.git cd financial-management bash deploy/docker-up.sh

Recommended; auto-generates secrets, pulls GHCR images (works in mainland China), runs health checks

How to configure 家庭账房 · Family Ledger

  • DB_NAMEfinanceDatabase name

    Database name

  • DB_PASSDatabase password

    Database password

  • DB_USERfinanceDatabase user

    Database user

  • FINANCE_KEEP_DEMO0Keep demo data on fresh install

    Keep demo data on fresh install

    values: 1

  • FUTU_ALLOW_UNVERIFIED0Allow unverified Futu OpenD versions

    Allow unverified Futu OpenD versions

    values: 1

  • FUTU_API_RSA1Disable RSA encryption for Futu API channel

    Disable RSA encryption for Futu API channel

    values: 0

  • FUTU_ENABLED0Enable Futu OpenD gateway profile

    Enable Futu OpenD gateway profile

    values: 1

  • FUTU_OPEND_IMAGECustom Futu OpenD image

    Custom Futu OpenD image

  • MYSQL_IMAGEghcr.io/luodi-nate/financial-management-mysql:8.0MySQL Docker image (GHCR mirror or Docker Hub)

    MySQL Docker image (GHCR mirror or Docker Hub)

    values: mysql:8.0

  • MYSQL_ROOT_PASSWORDMySQL root password

    MySQL root password

  • REMEMBER_ME_KEYSession signing key (32-byte random)

    Session signing key (32-byte random)

  • RETENTION_DAYS56Backup retention days

    Backup retention days

  • SEED_ADMIN_PASSWORDdemo1234Initial password for seed users (diwa/wangergou)

    Initial password for seed users (diwa/wangergou)

  • SERVER_PORT20000Application server port

    Application server port

  • TZAsia/ShanghaiTimezone

    Timezone

家庭账房 · Family Ledger releases & version history

FAQ

我能托管多个家庭吗?

Currently single-family design (one deployment = one family). For multiple families, deploy separate instances.

docker compose down 会丢数据吗?

No, data lives in named volumes (db-data, uploads, backups). Only `down -v` deletes volumes.

股票 / 加密货币 / 汇率拉不到值?

All use free public APIs (Sina/Tencent for stocks, Binance/CoinGecko/Coinbase for crypto, Frankfurter for FX) but require outbound internet. Falls back to last known values; FX can be manually entered at /admin/fx.

不配 AI / 短信能用吗?

Yes, all external services are optional. Core features (accounting, net worth, true returns, charts) work with zero configuration.

忘记密码、把自己锁外面了怎么办?

Set password_hash to PLACEHOLDER_RESET in database for the user, restart app; seed runner resets to SEED_ADMIN_PASSWORD (default demo1234), then forces password change on login.

部署在远程 VPS,为什么浏览器打不开 :20000?

Default binds only to 127.0.0.1 (loopback). Use SSH tunnel or set up nginx/Caddy reverse proxy with HTTPS.

最低需要什么配置?

1 GB RAM, 1 CPU core, ~2 GB disk. 512 MB machines will OOM.

More in Finance & Budgeting

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…