# Actual

Actual Budget is a fast, privacy-focused personal finance app built around the Envelope Budgeting methodology. It runs locally-first across desktop, mobile, and web, with optional sync via a self-hosted server (*this one*) and optional end-to-end encryption.

**When does managed Actual make sense?**

- **Multi-device budgeting** with sync across desktop, mobile (*iOS / Android*), and web, without trusting a commercial finance app with your data.
- **Family or household budget**: one Actual server, multiple budget files, multiple devices.
- **Privacy-first migration** away from YNAB or commercial budgeting apps that require their cloud.
- **Pair with [Wallos](</app/wallos/>)** to track recurring subscriptions alongside everyday transactions.
- **Optional API access** for third-party widgets, automation, and integrations (*see below*).

You own your data: budgets are CSV-exportable, the format is documented, and end-to-end encryption is opt-in.

[Get a 7-day trial of ElfHosted Actual! 🪄](<https://store.elfhosted.com/product/actual-budget/>)

## How do I access Actual?

Actual is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-actual.elfhosted.com](<https://your-username-actual.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/actual/>) and these become your personal, clickable links.

## How to use Actual

### API Access

A [community-maintained API "wrapper"](<https://github.com/jhonderson/actual-http-api/>) is attached to your Actual pod, for optional integration with 3<sup>rd</sup>-party tooling like [https://github.com/TaylorJns/Actual-Budget-iOS-Widget](<https://github.com/TaylorJns/Actual-Budget-iOS-Widget>).

The API will be non-functional until you to set 2 additional environment variables using [ElfBot](<https://docs-internal.elfhosted.com/app/elfbot/>):

- `ACTUAL_SERVER_PASSWORD`: Your own server password
- `API_KEY`: A new API key you make up, using something like `apg -m 50 -n 1`

The API will be accessible, by default, at `https://<your username>-actual-api.<domain>`, and a [custom domain addon](<https://store.elfhosted.com/product/actual-budget-api-custom-domain-addon/>) is available. The API itself will **not** be linked on your ElfHosted apps dashboard or your health tab. Replace `<domain>` with the domain in your dashboard's address (*for example `elfhosted.com`*).

## Actual also works with

- [x] [Wallos](</app/wallos/>)

## How do I get support for Actual?

1. For general use of Actual, refer to the [official site](<https://actualbudget.org/>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## Sponsor Actual ❤️

You can contribute directly to the development of Actual using the following:

- [Open Collective](<https://opencollective.com/actual>)

## Actual resources

- [Actual (*official site*)](<https://actualbudget.org/>)
- [Actual GitHub](<https://github.com/actualbudget/actual>)
- [Actual Discord](<https://discord.gg/8JfAXSgfRf>)
