Docs

Documentation

How to use Simple Balance: signing up, bringing in your first statement, what each part of the app does, and running your own copy.

28 pages in 5 sections

Get started

Your first visit to app.smpl.money, one step at a time, from signing up to seeing where your money went.

3 pages

  • Finding your way around

    What each screen in the sidebar is for, how to choose the dates a screen shows, and the search, sort and row menus every list shares.

  • Frequently asked questions

    Short answers about the free budget app, Simple Balance. Which banks and files work, phones, sharing, currencies, AI assistants and your data.

Using Simple Balance

Your accounts and transactions day to day: bringing in statements, sorting them, and the payments that repeat.

11 pages

  • The overview

    What the Overview shows for the dates you pick, from your balance and money in and out to each account, top spending and your budget.

  • Accounts

    Add checking, savings, credit card, loan, cash and crypto accounts, read each one’s balances and register, and archive or delete old ones.

  • Adding and editing transactions

    Add a deposit, withdrawal or transfer, split a receipt across categories, find any entry, and edit, delete, restore or copy it.

  • Importing a statement

    Download a CSV from your bank, match its columns on Import/Export, and check every row on Staged before any of it counts toward a balance.

  • Staged transactions and duplicates

    Staged is the review queue. Imported, recurring and hand-staged rows wait there, count toward nothing, and post only when you commit them.

  • Categories and payees

    Add, group, rename, archive, delete and merge categories, and merge payee spellings, so your spending adds up under names you recognize.

  • Transaction templates

    Save a transaction you enter often as a template, fill in the next one with one pick, and get an email reminder when it’s due.

  • Recurring transactions

    Set up rent, pay or a subscription once. On each due date a row waits on Staged for you to check and commit, with an email if you want one.

  • Changing many transactions at once

    Select transactions, then change their category, date, payee, account or type, or delete them, up to 10,000 in one step, all or nothing.

  • More than one currency

    Keep accounts in different currencies or crypto assets. Simple Balance records what moved in each one and never converts at an exchange rate.

Budgets and reports

Plan what each month is for, save toward the bills you can see coming, and see where the money went.

3 pages

  • Budgets

    Set a budget for a category or a group, compare it with what you spent each month, change one month on its own, and carry what’s left over.

  • Reports

    Net worth, income and expenses, spending by category, cash flow, a balance sheet and a trial balance, for any dates, by week, month, quarter or year.

Your account

How things look, what’s been changed and when, connecting an AI assistant, your plan, and the limits you can meet.

5 pages

  • Theme, timezone and currency

    Switch between light and dark, set the timezone that decides what today is, and pick the currency new accounts and budgets start in.

  • Activity history

    Every change made to your books, by you, a connected AI assistant or a schedule, listed newest first, kept in order and never rewritten.

  • Connecting an AI assistant (MCP)

    Connect ChatGPT, Claude, Gemini, Codex or Claude Code to Simple Balance at app.smpl.money/mcp: setup for each, what it can change, and what to do when it fails.

  • Your account and plan

    Sign in and reset your password, upgrade to Premium or cancel, take your data with you, and delete your account on app.smpl.money.

  • Limits

    Every limit you can reach in Simple Balance, from 3 accounts on the free plan to 10,000 rows in one import, and what to do when you reach one.

For people who run their own copy

Self-hosting

Simple Balance also runs on machines you control. Try it on your own computer, run it for real on a server, keep it backed up, and move your whole ledger between your copy and the cloud app.

6 pages

  • Self-hosting: running your own copy

    Simple Balance is open source and free to run yourself, with no plan, no account limit and no ads. What it needs, how to try it, and how to run it for real.

  • Deploying with Docker Compose

    Run Simple Balance with Docker Compose on Linux machines you already have, with Caddy for HTTPS, systemd to start it on boot, and a nightly backup.

  • Deploying to Oracle Cloud or AWS

    Let a Pulumi program build Simple Balance’s machines, network, secrets and nightly backups on Oracle Cloud or AWS, then point a DNS name at it and sign in.

  • Configuration

    Every environment variable the server reads, what it defaults to, and which ones it refuses to start without.