Why Local-First Finance Tracking Is Worth the Setup Time
Most personal finance apps want two things from you: your bank credentials and a monthly subscription fee. In exchange, you get dashboards, automatic syncing, and the quiet unease of knowing a third-party server holds every transaction you have ever made. Local-first budgeting flips that model entirely – your data lives on your own machine, syncs only on your terms, and no one else touches it unless you decide otherwise.
The appeal goes beyond privacy. When your budget exists as a file you own, you can back it up exactly like any other document, move it between devices without logging into anything, and keep using it even if the developer behind your favorite app shuts down. That kind of long-term stability is difficult to find in the subscription-software world.
This guide walks through setting up a real, functional budgeting system using Actual Budget – a local-first, open-source personal finance tool that runs entirely on your hardware.
What Actual Budget Is and How It Works
Actual Budget started as a paid app and was later released as open-source software after its original developer stepped back from commercial development. The project is now maintained by a community of contributors and available for free. It uses an envelope budgeting method, which means every dollar you have gets assigned to a category before you spend it – not tracked after the fact. This approach forces a more deliberate relationship with money because the allocation happens at the beginning of a month, not as a retroactive label on past spending.
The application runs as a local Node.js server on your machine, and you access it through a web browser at a localhost address. There is no account creation, no email verification, and no cloud dependency in the default setup. Your budget data is stored as a SQLite file on disk. If you want to sync across multiple devices, you can self-host the sync server component on something like a home NAS or a Raspberry Pi sitting on your local network – but even without that, a single-machine setup is fully functional from day one.
Actual Budget supports manual transaction entry and CSV import from your bank’s export feature. It does not connect directly to bank accounts in most self-hosted configurations, which is a deliberate trade-off. You do slightly more data entry, but your banking credentials never leave your hands. For anyone who has watched a financial aggregator service get breached or shut down unexpectedly, this constraint starts to look less like a limitation and more like a feature.
Installing and Configuring Actual Budget
The easiest way to get started is through the official Actual Budget desktop app, which bundles everything into a single downloadable package for Windows, macOS, and Linux. Download it from actualbudget.org, install it like any other application, and open it. The first launch takes you directly into the budget setup wizard – no configuration files, no terminal commands required at this stage.
Once inside, the setup wizard asks you to create a budget file and name it. Think of this file as your financial workspace. You will be prompted to add your accounts first – checking, savings, credit cards, and any other accounts you want to track. These are created manually: you enter the account name, type, and current balance. Actual Budget does not pull this information from anywhere; you are the source of truth. After accounts are created, the next step is building your category structure. The app comes with a default set of categories – housing, food, transportation, entertainment, and so on – but these are fully editable. Delete what does not apply, rename anything that is too generic, and add categories that reflect how your money actually moves. A well-designed category list is the foundation that makes the rest of the system work, so spending fifteen minutes here pays off every month after.
With accounts and categories in place, assign your available money to categories using the budget view. Each month shows a column of categories, a “budgeted” field where you enter how much you plan to spend, and a running balance that adjusts as transactions come in. Enter your total available funds by assigning amounts across categories until the “to budget” number at the top reaches zero. That zero is the goal – every dollar accounted for. From this point forward, adding transactions is the main ongoing task: either enter them manually as you spend, or export a CSV from your bank at the end of each week and import it using the built-in import tool under the account view.
Syncing Across Devices Without a Cloud Service
If you use more than one device and want your budget available on all of them, Actual Budget includes a self-hosted sync server option called Actual Server. The sync server is a lightweight Node.js application that you run on any always-on machine in your home network – a Raspberry Pi, an old laptop, or a home server. It stores an encrypted copy of your budget file and handles merging changes from multiple devices, so edits made on your phone and your laptop stay consistent without any cloud intermediary.
Setting up Actual Server requires Docker or a direct Node.js installation. The Docker route is faster: pull the actualbudget/actual-server image, run a container with a mapped volume for persistent storage, and expose port 5006 on your local network. The Actual Budget desktop or web app then connects to this server address instead of storing data only locally. If you are already running self-hosted services at home – and if you have set up something like a self-hosted RSS reader or similar tools – adding Actual Server to the stack takes less than twenty minutes.
One important detail: Actual Server encrypts the budget file before storing it, using a password you set during the initial connection. Even if someone gained access to the server’s storage volume, the file is unreadable without that password. Keep that password somewhere secure – a password manager is the obvious choice – because there is no recovery mechanism if you forget it. The trade-off for total data ownership is that you are also the only person responsible for maintaining access.
After a month of use, the envelope system starts changing how spending decisions feel in real time – when a dining category hits zero mid-month, the choice becomes explicit: stop eating out, or move money from somewhere else and accept the trade-off. That visible constraint, right there in a browser tab on your own machine, is what most subscription budgeting apps are trying to sell you – except here, the file is yours, the server is yours, and no pricing change in a startup’s growth plan ever touches it.
