Assembly instructions

actualbudget/actual

A local-first personal finance app

Node.js#budgeting#finance#money#personal-finance

Difficulty: Easy
Time: about 5 min
Stars: ★ 29,978
Activity: Updated this month
License: MIT
Open issues: 198
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Start here

Website ↗actualbudget.orgThe project's own site.Docs ↗actualbudget.orgLinked from the README.In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

Download for macOS

v26.11.0 · 11/2/2026 ↗

Actual-mac-arm64.dmg

dmg · Apple Silicon · 145.8 MB · 1,508 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/actualbudget/actual/releases/download/v26.11.0/Actual-mac-arm64.dmg"
open "Actual-mac-arm64.dmg"

Other macOS downloads (1)

Actual-mac-x64.dmg

dmg · Intel · 152.7 MB · 146 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/actualbudget/actual/releases/download/v26.11.0/Actual-mac-x64.dmg"
open "Actual-mac-x64.dmg"

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 13 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js v24.22.1runtime
1×yarn yarn@4.17.1package manager

Share this manual

Good to know

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: node:24-bookworm).
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: packages/api/package.json, packages/ci-actions/package.json, packages/cli/package.json, packages/component-library/package.json and 10 more

package.json scripts (49)

startyarn start:browser
start:serveryarn workspace @actual-app/sync-server start
start:server-monitoryarn workspace @actual-app/sync-server start-monitor
start:server-devNODE_ENV=development BROWSER_OPEN=localhost:5006 yarn npm-run-all --parallel 'start:server-monitor' 'start'
start:desktopyarn desktop-dependencies && npm-run-all --parallel 'start:desktop-*'
start:docsyarn workspace docs start
desktop-dependenciesnpm-run-all --parallel rebuild-electron build:plugins-service
start:desktop-nodeyarn workspace @actual-app/core watch:node
start:desktop-clientyarn workspace @actual-app/web watch
start:desktop-server-clientyarn workspace @actual-app/web build:browser
start:desktop-electronyarn workspace desktop-electron watch
start:browsernpm-run-all --parallel 'start:browser-*' 'start:service-plugins'
start:service-pluginsyarn workspace plugins-service watch
start:browser-frontendyarn workspace @actual-app/web start:browser
start:storybookyarn workspace @actual-app/components start:storybook
buildlage build
start:iosyarn build:browser && yarn workspace mobile-client start:ios
start:androidyarn build:browser && yarn workspace mobile-client start:android
build:serveryarn build:browser && yarn workspace @actual-app/sync-server build
build:browser./bin/package-browser
build:desktop./bin/package-electron
build:plugins-serviceyarn workspace plugins-service build
build:apiyarn build --scope=@actual-app/api
build:mobileyarn build --scope=mobile-client
build:cliyarn build --scope=@actual-app/cli

Files we read (13)

.devcontainer/devcontainer.json

.github/workflows/api-browser-test.yml

.github/workflows/build.yml

.github/workflows/check.yml

.github/workflows/crdt-version-check.yml

.github/workflows/e2e-test.yml

.github/workflows/news-feed-check.yml

.nvmrc

CONTRIBUTING.md

Dockerfile

README.md

docker-compose.yml

package.json

Branch master · 4,400 files in the repo

Reading the repo

Start here

Yes, it installs on your macOS

Download for macOS

Did you get it running?

Still stuck? Get a written guide

Opening the box…

Start here

Yes, it installs on your macOS

Download for macOS

Did you get it running?

Still stuck? Get a written guide