Actual is a free, open source personal finance management project written in TypeScript and released under MIT. It has 28,976 GitHub stars, 2,991 forks and 252 open issues, and was last pushed 7 hours ago. On this registry it ranks #2 of 12 tracked projects in Personal Finance Management, with 5 head-to-head comparisons available. It gained 258 stars over the last 6 tracked days.

Actual — Local-first envelope budgeting with full data ownership

What is Actual?

What it is

Actual is a local-first personal finance application built for envelope budgeting, part of the open-source personal finance ecosystem. It runs entirely on the user’s device by default, ensuring data remains under full local control, while optionally syncing changes across devices via a self-managed or hosted backend.

It solves the problem of proprietary budgeting tools that lock user data behind cloud services or paid subscriptions. Actual eliminates vendor lock-in by storing all financial data in a local SQLite database, enabling users to own, inspect, and migrate their data without reliance on third-party infrastructure.

Key capabilities

  • Envelope budgeting with rolling monthly allocations and category-based spending limits
  • Local-first data storage using SQLite, with optional sync via a self-hosted or Fly.io/PikaPods backend
  • Multi-device synchronization using a conflict-aware, bidirectional sync protocol
  • Import/export of financial data via CSV, YNAB4, and Actual’s own JSON schema
  • Customizable account types (checking, savings, credit, cash) with reconciliation support
  • Transaction filtering, categorization, and recurring transaction rules
  • Extensible architecture via Node.js core (loot-core) and modular UI packages

Who uses it and how

  • Self-hoster users deploy the Docker image or native desktop apps to maintain full control over sensitive financial data
  • Migrators from YNAB or other envelope budgeting tools use the provided CSV and YNAB4 import workflows to transition budgets
  • Non-technical users adopt managed hosting via PikaPods or Fly.io to avoid local setup while retaining data ownership
  • Contributors extend functionality by modifying the loot-core, desktop-client, or desktop-electron packages

Getting started

Install via downloadable desktop apps for Windows, macOS, and Linux, or deploy using Docker (actualbudget/actual-server), Fly.io, or PikaPods. The app launches locally with no account required; sync is enabled by configuring a remote server URL.

When to use it — and when not to

Use Actual when data ownership, offline access, and envelope-style budgeting are priorities, and when you can manage local storage or self-host sync. Avoid it if you require automated bank feeds, investment tracking, or multi-user collaboration—its sync is device-to-device only, and it lacks native integrations with banking APIs. Self-hosting requires managing a Node.js server, SQLite database, and optional SMTP for notifications.

project readme (upstream, from github) — read inline

Getting Started

Actual is a local-first personal finance tool. It is 100% free and open-source, written in NodeJS, it has a synchronization element so that all your changes can move between devices without any heavy lifting.

If you are interested in contributing, or want to know how development works, see our contributing document we would love to have you.

Want to say thanks? Click the ⭐ at the top of the page.

Key Links

Installation

There are four ways to deploy Actual:

  1. One-click deployment via PikaPods (~2.00 $/month) - recommended for non-technical users
  2. Managed hosting via Fly.io (~1.50 $/month)
  3. Self-hosted by using a Docker image
  4. Local-only apps - downloadable Windows, Mac and Linux apps you can run on your device

Learn more in the installation instructions docs.

Ready to Start Budgeting?

Read about Envelope budgeting to know more about the idea behind Actual Budget.

Are you new to budgeting or want to start fresh?

Check out the community's Starting Fresh guide so you can quickly get up and running!

Are you migrating from other budgeting apps?

Check out the community's Migration guide to start jumping on the Actual Budget train!

Documentation

We have a wide range of documentation on how to use Actual, this is all available in our Community Documentation, this includes topics on Budgeting, Account Management, Tips & Tricks and some documentation for developers.

Contributing

Actual is a community driven product. Learn more about contributing to Actual.

Code structure

The Actual app is split up into a few packages:

  • loot-core - The core application that runs on any platform
  • desktop-client - The desktop UI
  • desktop-electron - The desktop app

More information on the project structure is available in our community documentation.

Feature Requests

Current feature requests can be seen here. Vote for your favorite requests by reacting :+1: to the top comment of the request.

To add new feature requests, open a new Issue of the "Feature Request" type.

Translation

Make Actual Budget accessible to more people by helping with the Internationalization of Actual. We are using a crowd sourcing tool to manage the translations, see our Weblate Project. Weblate proudly supports open-source software projects through their Libre plan.

Translation status

Repo Activity

Alt

Sponsors

Thanks to our wonderful sponsors who make Actual Budget possible!

Deploys by Netlify Built with Depot Docker GitHub Anthropic

Frequently asked questions

Is Actual free to use?

Actual is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does Actual do?

Local-first envelope budgeting with full data ownership

What is Actual written in?

Actual is primarily written in TypeScript. Its source is publicly available at https://github.com/actualbudget/actual, and it has 28,976 GitHub stars.