DevPik Logo
budgetingpersonal financemoneyself hostedenvelope budgeting

Actual Budget: A Free Local-First Budgeting App That Shows Where Every Dollar Goes

Actual Budget is a free local-first budgeting app that shows you where every dollar goes. It uses envelope budgeting, keeps your data on your own device, syncs it across your phone and computer, and runs on Windows, Mac, and Linux. It has 30,000+ stars on GitHub and costs nothing to use.

ByMuhammad Tayyab7 min read
All open source picks
actualbudget/actual
The official repository — this write-up is not affiliated with the project.
30.4kTypeScriptMIT

What Actual Budget Is: Envelope Budgeting on Your Own Device

Actual Budget is a local-first personal finance tool, and it is 100 percent free and open source under the MIT license, with 30,372 stars on GitHub. The idea is simple: a budgeting app should show you where every dollar goes, and your financial data should live on your own device, not on somebody else's server. It is built in Node.js and split into packages for the core engine, the desktop client, and the desktop app, and a sync element moves your changes between devices without any heavy lifting. The budgeting method behind it is envelope budgeting. You give each dollar a job, like rent, food, or savings, before you spend it, and the app shows you what is left in each envelope at any moment.

Envelope Budgeting: Give Every Dollar a Job Before You Spend It

Envelope budgeting is the whole method, and Actual Budget is built around it instead of bolting it on. When money comes in, you assign it to envelopes for the things you actually pay for. Rent gets its envelope, food gets its envelope, savings gets its envelope, and the app keeps a running balance for each one. When you spend, the money comes out of the right envelope, so you always know whether you can still afford something before you buy it. The project docs explain the method in full, and there is a Starting Fresh guide for people who are new to budgeting or want to begin again with a clean slate. It is the opposite of a bank statement that only tells you what you already spent.

Local-First: Your Data Stays on Your Device

The part that sets Actual Budget apart from most budgeting apps is that it is local-first. Your budget lives on your own device. There is no account you have to create and no cloud service holding your finances. If you use more than one device, the sync element keeps your phone and your computer in step, but the data is still yours and it still lives with you. That matters for a budgeting app more than for almost any other kind of tool, because a budget is a record of your whole financial life. The downloadable apps run on Windows, Mac, and Linux, so the local-only setup works the same way whatever computer you use.

Moving From Another Budgeting App

Most people who try Actual Budget are switching from something else, and the project expects that. The docs have a migration guide for bringing a budget over from another app, so you do not start from zero. If your old app lets you export your data as a CSV file, a quick CSV to JSON pass lets you check the shape of that export before you import it, so account names and categories land correctly instead of needing a cleanup round afterwards. And if you would rather start clean, the Starting Fresh guide walks through setting up envelopes from scratch. Either way, the move takes an evening, not a weekend.

Tracking Money In: Paydays, Side Income, and Invoices

A budget has two sides, and Actual Budget handles the money coming in as well as the money going out. Paydays land in your envelopes the same way any other income does, and if you freelance or run a small side business, the same flow works for client payments. Send the invoice with an AI Invoice Generator, then record the payment in Actual Budget when it arrives, and the money is already assigned to the right envelope. It keeps the business side of your finances in the same place as the personal side, which is exactly where a budget belongs.

Installing Actual Budget: Local Apps, Docker, or Managed Hosting

There are four ways to run Actual Budget, and the free ones are the default. The simplest is the local-only apps: download the Windows, Mac, or Linux app and run it on your device, no server needed. If you want sync between devices, self-host with the Docker image. And if you do not want to set anything up yourself, managed hosting is about 1.50 dollars a month on Fly.io or about 2 dollars a month on PikaPods, which the project recommends for non-technical users. The hosting is optional. The app itself is free, the code is on GitHub under the MIT license, and the community docs cover budgeting, account management, tips and tricks, and developer setup if you want to contribute.

Frequently Asked Questions

What is Actual Budget?

Actual Budget is a free local-first personal finance app that uses envelope budgeting to show you where every dollar goes. It has 30,000+ stars on GitHub. Your data stays on your own device, it syncs across your phone and computer, and there are apps for Windows, Mac, and Linux.

Is Actual Budget really free?

Yes. Actual Budget is 100 percent free and open source under the MIT license. The local apps and the self-hosted Docker setup cost nothing. Optional managed hosting is about 1.50 to 2 dollars a month if you do not want to set it up yourself, but it is not required.

What is envelope budgeting?

Envelope budgeting means giving each dollar a job before you spend it. You assign your income to envelopes like rent, food, or savings, and each envelope keeps its own balance. When you spend, the money comes out of the right envelope, so you always know what is left before you buy something.

Does my data leave my device?

No. Actual Budget is local-first, so your budget lives on your own device. A sync element keeps your changes in step across your phone and computer, but there is no cloud account holding your finances.

Can I move my budget from another app?

Yes. The docs have a migration guide for bringing a budget over from another budgeting app, and a Starting Fresh guide if you would rather begin with a clean slate. If your old app exports CSV, check the shape of the export before you import it.

How much does managed hosting cost?

Managed hosting is optional and costs about 1.50 dollars a month on Fly.io or about 2 dollars a month on PikaPods. The project recommends PikaPods for non-technical users. Self-hosting with Docker and the local apps are free.

Related DevPik tools

Muhammad Tayyab

Written by

Muhammad Tayyab

Founder of DevPik

Muhammad Tayyab founded DevPik and builds its free developer tools. He writes about developer tools, AI and web technology.

More open source picks