Shipping, v3.13.0. Open source under AGPL-3.0.
CloudBank
Your money, self-hosted. A free personal finance manager — a from-scratch web port of HomeBank, built for the browser and the cloud.
Contents
What it does
- Accounts3
- Transactions3
- The register3
- Bills on a calendar3
- Budgets and reports3
- Savings goals4
- Vehicles4
- The wallet's lists4
- Import and export4
- Automatic bank sync5
- Currencies and users5
- Six languages5
- Privacy mode5
- A dashboard of your own6
- Bank mails8
- Notifications11
- Security and sign-in13
- Optional AI14
- Phone and Home Assistant18
Getting it
This ledger belongs to whoever runs it.
Try it without installing anything
A live CloudBank with a year of made-up money in it. One button gives you an account of your own — no sign-up, no email, no password — so change anything you like.
What it is
CloudBank brings the HomeBank workflow — accounts, a powerful transaction register, scheduled transactions, budgets and rich reports — to a web UI you can reach from any device. It ships as a single Docker container, with no external database to run.
An independent, clean-room reimplementation: it doesn't copy or link any HomeBank source code, and it tracks parity with current and future HomeBank releases.
Features
- Every account typeBank, cash, checking, savings, credit card, liability, asset and investment — each with its own currency, payment mode, and today's and a projected balance.
- Transactions12 payment types, the cleared/reconciled lifecycle, category splits, free tags, internal and cross-currency transfers, bulk edit and duplicate detection.
- Powerful registerRunning balance, rich filtering, full-text search, per-user columns, a live selection total and reconciliation. New entries go in a sheet beside the ledger.
- Bills on a calendarScheduled transactions with automatic posting, on the day each falls: still to pay, overdue, and what needs you. It also finds payments that repeat on their own, shows what each costs in a year, and puts them in your phone's calendar.
- Budgets and reports that answer firstPlanned next to spent, and reports for where the money went, cash flow, balances and what a car costs, with saved views and CSV/PNG downloads.
More of it
- Savings goalsWhat you have set aside, what to put aside each month to meet every date, and what is free to spend once it is.
- VehiclesWhat each car, motorbike or van costs to run over the last year: fuel, kilometres, cost per kilometre and consumption.
- The wallet's listsCategories, payees, tags, rules, templates and currencies each get a page, with what every entry did over 12 months.
- Import and exportImport HomeBank
.xhb, QIF, OFX/QFX, CSV and CAMT.053 with an assistant; export back to.xhb, QIF and CSV.
And the rest
- Automatic bank syncNew transactions straight from your bank, merged with what you entered and run through your rules — via SimpleFIN, Enable Banking or, experimentally, Pluggy. A review page settles the rest.
- Multi-currency, multi-userManual and online (ECB, frankfurter.app) exchange rates, admin-managed users and a responsive UI.
- Six languagesEnglish and Italian, plus Spanish, French, German and Brazilian Portuguese in beta, picked from the browser on a first visit.
- Privacy modeOne eye beside the ? of every page, or Shift+H, blurs amounts, balances, memos and payees, charts included.
Make it yours
The dashboard is a free-form grid: place and resize widgets anywhere, and add any of them more than once — balances, quick-add, spending donut, budget gauge, upcoming, recent transactions, key figures and notes.
Light, dark or auto themes with an accent colour that follows you across devices, a reorderable sidebar, HomeBank-style smart amount entry, and a short tour on each page.
Taped in




Bank mails
CloudBank reads your bank's payment notifications from one folder of a mailbox and writes each one into the register as a cleared transaction. It only reads: nothing is marked read, moved or deleted.
- Any mailboxOutlook.com, Hotmail or Live by signing in to Microsoft; Gmail, Libero, iCloud and the rest over IMAP with an app password.
- A pattern, or the AIHighlight the amount and the merchant in a real mail once. The AI, if you set one up, reads what no pattern does, with card numbers and IBANs hidden first.
- No doubles, no forgeriesBank sync merges its own row into the mail's, Review asks about the ones the bank never booked, and only senders the mail server authenticated count.
Step by step, with an example: the bank mails guide.
8From the mail


More taped in




Notifications
A bell on every page keeps what happened: a bill that is due, a sign-in from a new device, a mailbox that stopped reading, a large expense. The same news can reach you outside CloudBank too.
- Where you will see itPush, email, Matrix, Telegram, Discord, Slack, ntfy, Gotify or a webhook for Home Assistant, each checked with a test message.
- What goes whereBills, security, problems, money and summaries: each event goes to the channels you pick for it.
- And whenOne daily digest instead of a message each time, a weekly or monthly summary, and quiet hours at night.
Every channel, step by step: the notifications guide.
11The bell, and where it rings


Secure, and on every device
- Two-factor authOptional per-user TOTP — QR enrolment, recovery codes and a two-step login.
- Single sign-onAuthelia, Authentik, Keycloak or Google, next to passwords or in their place.
- Installable PWAInstall CloudBank to your phone's home screen or your desktop, with an offline shell and shortcuts for a new expense or income.
- Personal API tokensScoped, revocable bearer tokens; the secret is shown once. Home Assistant reads a wallet summary with one.
- Encrypted secrets at restSet
CB_SECRET_KEYto encrypt bank credentials, mailbox passwords, AI keys and 2FA secrets with AES-256-GCM. - Told when to updateA new build is offered, not swapped in under you; admins hear when a newer CloudBank is out.
Optional AI, with your own key
Off until you set it up, with any OpenAI-compatible service or a model on your own network. CloudBank works out every number; the model only writes the words, and nothing it proposes is saved until you save it.
- ReportsA report on each month, and on each week and year if you like, with Why? to see the numbers it was given.
- ProposalsBudgets from what you really spend, rules for the payees you always file alike, subscriptions that cost more, goals falling behind.
- Unusual transactionsA payee far over its usual amount, a large new payee, a charge taken twice.
And around the numbers
- Ask your dataA question in your own words, answered from CloudBank's own queries, with the numbers it used.
- Quick entryType "coffee 3.50 yesterday", share a notification or snap a receipt, and review it.
- Tidying upCategories for what Review left without one, clean names for raw bank payees, the columns of a new CSV.
- Bank mailsMails no pattern reads, card numbers and IBANs hidden first.
- What it sendsEach job says it before you switch it on, and the last 90 days are kept word for word. Your key never leaves the server.
Setting it up, and what each job sees: the AI guide.
15Ask it, or show it a receipt


What the AI writes


From your phone, and Home Assistant
- Two taps to addA long press on the installed app's icon offers New expense and New income, in your language.
- Share a notificationOn Android, share the bank's notification with CloudBank: the entry sheet opens with its text, read by the AI if you use it.
- Home Assistant sensorsBills due, this month's budget and what waits on Review, read with an API token; balances only if you ask.
The sensors' YAML: the Home Assistant guide.


Run it yourself
Docker with the Compose plugin. One container, your data in a volume:
services:
cloudbank:
image: ghcr.io/easly1989/cloudbank:main
container_name: cloudbank
restart: unless-stopped
ports:
- "8080:8080"
environment:
CB_SECURE_COOKIES: "false" # plain-HTTP LAN only
volumes:
- cloudbank-data:/data
volumes:
cloudbank-data:
docker compose up -d # open http://localhost:8080
Stable, :main | v3.13.0, published 3 November 2026 |
|---|---|
Nightly, :latest | built from main, published on every change |
:main is the latest stable
release, while :latest is the bleeding-edge nightly. Pin
deliberately. CB_SECRET_KEY encrypts secrets at rest, and
CB_BANK_SYNC_INTERVAL sets how often background bank sync looks for
connections that are due (default 1h). An API reference is served at
/api/docs.
Open and free — support it
CloudBank is an open-source labour of love, released under the AGPL-3.0. If it's useful to you, a donation genuinely helps and is much appreciated.
20