Reading the repo

Opening the box…

How to install actual on macOS (actualbudget/actual) · gitmanual

How to install on macOS

actualbudget/actual

A local-first personal finance app

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

Difficulty: Easy
Time: about 5 min
Stars: ★ 30,020
Activity: Updated this month
License: MIT
Open issues: 211
Got it running: Be the first
Looked up: 13 h ago

GitHub didn't answer, so this is the saved copy from 13 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

macOS Windows Linux

Download for macOS

v26.11.0 · 11/2/2026 ↗

Actual-mac-arm64.dmg

dmg · Apple Silicon · 145.8 MB · 1,888 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 · 201 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? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

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

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/actualbudget/actual/badge.svg)](https://gitmanual.com/actualbudget/actual)

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,409 files in the repo