SparkBox / Guides / Actual Budget setup

How to set up Actual Budget

Privacy-first personal finance. This guide covers how to access it, log in for the first time, configure the basics, and where its data lives so you can back it up.

SparkBox Apps page — one-click install cards for every module
SparkBox Apps page — one-click install cards for every module

1. What is Actual Budget?

Self-hosted YNAB alternative. Track spending, set budgets, and manage finances with zero-knowledge end-to-end encryption. All data stays on your server.

2. Before you start

Create your first account after launching. Data is encrypted on your server.

3. How to access it

Once it's enabled, Actual Budget runs on your SparkBox at:

https://<your-NAS-IP>:5006

First visit will show a self-signed cert warning — accept it once. You can also install the Actual mobile/desktop apps and point them at this server to sync.

4. Tips

  • Your browser will warn about a self-signed certificate on first load — click Advanced → Proceed. The cert is generated locally and never leaves your server. It's required because Actual Budget's web UI uses SharedArrayBuffer, which browsers only expose over HTTPS.

5. Where your data lives

Actual Budget's config and persistent data are stored on the SparkBox host under:

/opt/sparkbox/modules/budget/config/

Backups via the SparkBox dashboard's Backup tile include this directory by default, so a single restore brings Actual Budget back to its current state on a fresh install.

Next steps

That's Actual Budget live on SparkBox.

If something doesn't match what you see, post in d/sparkbox or hit us up on YouTube. Every SparkBox bug gets patched; every UX-stumble in this guide gets rewritten.

Get SparkBox → More guides →

Questions, or did this not match your box?

Every guide here came from a real problem someone hit. If yours behaves differently, say so — that is how these get corrected, and how the fix gets prioritised.

Ask in the community →

We answer there rather than in a comment box, because that is where the people who have already solved it are.

About this guide: Generated from the SparkBox module manifest and verified against a live install. If you spot something that doesn't match your experience, tell us in d/sparkbox.