Repository navigation
Migrate from HomeBank
This page is copied from
docs/migrate-from-homebank.mdwhenever it changes. To correct it, open a pull request on that file.
CloudBank imports a HomeBank file (.xhb) directly — one upload recreates the
whole wallet: currencies, accounts, payees, categories, tags, transactions (with
splits and re-paired transfers), scheduled transactions and templates, assignment
rules and budgets. Amounts are converted exactly, so balances match HomeBank to
the cent.
CloudBank follows HomeBank's current release (5.10.4 at the time of writing); a scheduled check opens an issue whenever HomeBank publishes a newer one.
In HomeBank, your file is what you open from File → Open. By default it lives
in your home directory (for example ~/MyAccounts.xhb). It is a single,
self-contained XML file — no separate attachments are needed.
Tip: work on a copy. The import never modifies your
.xhb, but keeping the original untouched is good practice.
If you keep your data inside HomeBank's own folder and aren't sure of the path, use File → Save as… in HomeBank to write a fresh copy somewhere obvious.
- Log in to CloudBank.
- Go to Settings → Import & export, on the HomeBank file tab.
- Choose your
.xhbfile and click Import. - CloudBank creates a new wallet from the file and shows a summary of how many of each entity were imported, plus any warnings. The import is all-or-nothing: if anything fails, nothing is created.
Behind nginx? Its default upload limit is 1 MB, which most HomeBank files exceed, and the import then stops with a 413 error. Raise it first:
client_max_body_sizein the reverse-proxy guide shows how. CloudBank itself accepts files up to 64 MiB.
The new wallet becomes the active one. Open Accounts and the register to confirm your balances; they should equal HomeBank's exactly.
A quick check after importing:
- Accounts screen: each account's balance matches HomeBank.
- Register (Transactions): split transactions show their parts, and transfers are shown as linked pairs.
- Budget and Reports: your categories and budgets carried over.
- Schedules: your scheduled transactions are listed (CloudBank will resume posting them automatically).
If a balance is off, it almost always means the .xhb you imported wasn't the
latest save — re-export from HomeBank and import again into a fresh wallet.
- Connect your bank in Settings → Bank sync (the bank-sync guide). A bank row that matches a transaction you already have — the same amount on a nearby date — is merged into it rather than added twice, so your history and the new rows line up.
- Let the rules you brought over do the typing. Your HomeBank assignment rules run on every bank sync, and on a file import when you tick the option.
-
Keep HomeBank as a way out. You can export the wallet back to
.xhbat any time (see below).
- Carried over: currencies and their rates, accounts and their flags, payees (with defaults), the two-level category tree, tags, every transaction with its payment mode, status, info, memo, splits and tags, internal transfers, templates, schedules, assignment rules and budgets.
- Not applicable: HomeBank UI preferences and window layout (CloudBank has its own preferences). Investment positions/quotes are not modelled (HomeBank itself has no live quotes; investment accounts behave as normal ledger accounts).
If you're coming from another tool, CloudBank also imports CSV (the HomeBank CSV dialect and generic mapped CSV), QIF, OFX/QFX and CAMT.053 (the ISO 20022 statement most European banks offer as a download) from the same section, on the Bank / CSV / QIF / OFX tab, with duplicate detection and optional rule application: see Importing transactions.
CloudBank can export a wallet back to a HomeBank .xhb file, so you're never
locked in. Go to Settings → Import & export, and under Backup & restore
click Export .xhb; the downloaded file opens directly in the HomeBank desktop app.
The export reverses the import exactly — accounts, payees, categories, tags, transactions (with splits and re-paired transfers), schedules, templates, assignment rules and budgets — so a round-trip (export from CloudBank → open in HomeBank, or export → re-import into a fresh CloudBank wallet) preserves entity counts and per-account balances to the cent.
Re-running the .xhb import always creates a new wallet, so it never clobbers
existing data. To move data back out, use the .xhb export above, CSV/QIF
export per account, or take a full wallet backup (portable JSON) from the
same Backup & restore panel.
Start here
Using CloudBank
- Using CloudBank, page by page
- Importing transactions
- Automatic bank sync
- Bank mails
- Notifications
- The AI, and what it sees
- CloudBank in Home Assistant
- Adding from your phone
- Ask your data
- Schedules in your phone's calendar
Running CloudBank
Extending CloudBank
Project