Projects About Donate GitHub
Back to the bench

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.

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.

Open the demo

It forgets you on purpose. Your demo account is deleted after two hours without use, every night, and whenever the demo is updated. Bank sync talks to a pretend bank, and attachments, AI, bank mails and notifications are off. What the demo is. Have a proper look, but don't put anything real in it — for that, run your own, which takes one container.
1

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.

CloudBank dashboard with today's balance, what was earned, spent and kept, and an income versus expense chart
The dashboard — a fully customizable, free-form grid of widgets.
2

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.
3

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.
4

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.
5

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.

Customizing the CloudBank dashboard by placing and resizing widgets on a grid
Drag, resize and add widgets from a palette.
6

Taped in

CloudBank dashboard in privacy mode, every figure blurred
Privacy mode — the figures blur, the page keeps its shape.
CloudBank register with four transactions selected and their total
The register, and one edit for a whole selection.
CloudBank cash flow report for 2026
Reports — spending, cash flow, balances and vehicle cost.
CloudBank schedules calendar for October
The month's bills on a calendar.
7

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.

8

From the mail

CloudBank's pattern editor beside a bank mail, the amount and the merchant marked and a piece selected
A pattern: say what each piece of a real mail is.
A CloudBank mailbox with its pattern and the latest mails, two of them created as transactions
The mailbox: its pattern, and what became of each mail.
9

More taped in

CloudBank budget for October, planned against spent
Budget — what you planned, next to what you spent.
CloudBank categories with each one's share of spending
Categories, edited in a panel beside the list.
CloudBank bank sync review with a possible duplicate pair
Bank sync review — settle possible duplicates.
CloudBank appearance settings
Appearance — theme, accent colour, the sidebar.
10

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.

11

The bell, and where it rings

The CloudBank dashboard with the bell open: a large expense, a budget at 80% and bills due
The bell: what happened, newest first.
CloudBank's notification settings with the channels and the events
Settings: the channels, and which events reach each one.
12

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_KEY to 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.
13

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.
14

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.

15

Ask it, or show it a receipt

CloudBank's AI insights answering how much went on restaurants this summer, with the numbers CloudBank computed below the answer
A question, and the numbers behind the answer.
CloudBank's entry sheet with a bakery receipt's photo, its total, date and memo filled in by the AI
A receipt's photo, read into the entry sheet.
16

What the AI writes

CloudBank's AI insights: August's report and five budgets to review, each with Apply
A month in short, and budgets from what you spend.
CloudBank's Review page with five unusual transactions, each with Open in the register and It's fine
What looks unusual, on Review.
17

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.

CloudBank settings with the six languages
Six languages, each by its own name.
CloudBank import and export settings
Import, export and full backups.
18

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, :mainv3.13.0, published 3 November 2026
Nightly, :latestbuilt from main, published on every change
19
Note the tag scheme. :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.

Donate GitHub Sponsors

20
That's the ledger. Put it back?

Back to the bench