Self-host 家庭账房 · Family Ledger
v1.37.0Self-hosted family wealth tracker with real returns
- Stars
- 372
- CPU
- 1 core
- RAM
- 1 GB
- Storage
- ~2 GB
- Port
- 20000 (HTTP application server)
- Requires
- MySQL 8
ghcr.io/luodi-nate/financial-management:latestWhat is 家庭账房 · Family Ledger?
家庭账房 (Family Ledger) is a self-hosted family wealth management application designed for households that want full control over their financial data. Instead of daily transaction logging, it uses a monthly snapshot model — each family member spends about 10 minutes per month entering account balances, and the system computes net worth trends, real returns adjusted for inflation (CPI/M2 baselines), and true annualized returns separating human-earned income from investment gains (XIRR/TWR). Key capabilities include: 10 account types (cash, stocks, funds, crypto, real estate, liabilities, insurance, etc.) with 16 built-in templates; fund look-through that breaks down public funds into actual stock/bond/cash holdings and SWICS industries; automatic daily valuation for stocks (Sina/Tencent), crypto (Binance/CoinGecko/Coinbase), precious metals (SGE/international), and off-exchange funds; AI-powered portfolio checkup across allocation, risk, liquidity, and returns with concrete rebalancing suggestions (LLM only interprets, never recommends products); multi-currency support (CNY/USD/HKD) with Frankfurter FX rates; optional expense analysis with Alipay/WeChat CSV import; financial goals (FIRE, education, emergency fund) with three-scenario projections; and a responsive UI that installs as an iOS PWA. Deployment is via Docker Compose (recommended, with GHCR images that work in mainland China) or systemd direct install on Linux/macOS. The app uses MySQL 8 for persistence, Spring Boot 3.3/Java 21 backend, Thymeleaf+HTMX frontend, and Spring Security with bcrypt+session cookies. All external integrations (LLM keys, stock/crypto/FX data, Futu broker sync, SMS reminders) are optional — core features work offline. Licensed AGPL-3.0.
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
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
ActualSelf-hosted, open-source personal finance app using envelope budgeting with multi-device sync, end-to-end encryption, and bank sync via goCardless and SimpleFIN.
actual-icalSelf-hosted open-source application that exposes Actual Budget scheduled transactions as an iCal feed for calendar integration.
akauntingSelf-hosted accounting and invoicing for freelancers and small businesses: free on-premise edition with multi-currency, client portal, reports and a paid app store.
BeeCountOpen-source Flutter bookkeeping app for iOS, Android and web with AI, OCR and voice entry, plus self-hosted sync and shared ledgers via a BeeCount Cloud Docker server.
Budget BoardOpen-source self-hosted finance app for accounts, transactions, budgets and goals, with SimpleFIN/LunchFlow bank sync, 2FA and OIDC login; built as a Mint alternative.
CloudQueryCloudQuery is an open-source, self-hosted cloud asset inventory that syncs 80+ sources into your database for SQL querying, CSPM, FinOps, and AI agents via MCP.
dockerSelf-hosted accounting software for small businesses with invoicing, expenses, and a modular app store. Runs via Docker or manual install on Laravel/Vue.js.
EquiblesA self-hosted server that feeds AI assistants with SEC filings, institutional holdings, insider trades, and market data via the Model Context Protocol.
Firefly IIISelf-hosted, open-source personal finance manager with double-entry bookkeeping, budgets, rules, recurring transactions, multi-currency, 2FA, reports and a REST API.
formanceFormance Stack is a self-hosted, open-source financial platform with a programmable double-entry ledger, unified payments API, and Numscript DSL.
Frappe LendingFrappe Lending is a self-hosted, open-source loan management system on ERPNext and Frappe Framework automating the lending lifecycle for financial institutions.
HammondTrack fuel and expenses across multiple vehicles with this self-hosted system. Supports multi-user setups and serves as an updated alternative to Clarkson.










0 comments