Bussola

Getting started

You need a computer or server with Docker. Nothing else.

1. Download two files into a new folder:

mkdir bussola && cd bussola
curl -LO https://github.com/marc0todar0/bussola/releases/latest/download/docker-compose.yml
curl -L -o .env https://github.com/marc0todar0/bussola/releases/latest/download/example.env

2. Open .env and fill in these three lines:

BUSSOLA_AUTH_USER=yourname          # the username you will sign in with
BUSSOLA_AUTH_PASS=your-password     # at least 6 characters
PGPASSWORD=long-random-string       # database password; you'll never type it again

To generate a random string, run openssl rand -hex 24.

3. Start Bussola:

docker compose up -d

The first time, this downloads the images, which takes a minute or two.

4. Open http://localhost:3000 (from another device: http://<server-ip>:3000). Sign in with the username and password from step 2, then name your first wallet. You're ready: go to Transactions and press N.

To stop it, run docker compose down. Your data is kept.

Optional extras

Extra	Guide
Automatic prices for ETFs, stocks and crypto	Price updates
Transactions from bank notifications	Bank notifications
HTTPS, passkeys, phone notifications	Installation

Screenshots

Keypad that does arithmetic	Portfolio across four pillars
Bank mode (H)	Passkeys

Features

• Every account, one total. Banks, cards, payment apps, brokers, exchanges, cash. You can archive old ones and their history stays.
• Spending and net worth together. Expenses and income month by month, next to ETFs, stocks, bonds, crypto and deposits, with automatic prices if you want them.
• No bank passwords. Your phone forwards bank notifications and a language model turns them into drafts you accept in one tap. You can also import any bank's CSV.
• Shared on your terms. Many users, many wallets, each shared read or read-write. PostgreSQL row-level security keeps the wallets apart.
• Also: a keypad that does arithmetic, bank mode (H hides every amount), passkeys, six languages, a currency per wallet, keyboard shortcuts, dark theme, installable on a phone.

How it compares with Firefly III, Actual, Ghostfolio and Sure, and who it is not for: Comparison.

Documentation

• Installation: HTTPS, home servers, troubleshooting
• Using Bussola: wallets, transactions, sharing, shortcuts
• Bank notifications: phone setup and the reading model
• Price updates
• Configuration: every .env setting
• Backups and upgrades
• Contributing

Support the development

Bussola is free and stays free: no paid plans, no premium features. If it helps you, you can donate.

License

MIT. See LICENSE.