# ![Actual Budget](<https://daemonless.io/images/logos/actual.svg>) Actual Budget

[![Build Status](<https://img.shields.io/github/actions/workflow/status/daemonless/actual/build.yaml?style=flat-square&amp;label=Build&amp;color=green>)](<https://github.com/daemonless/actual/actions>) [![Last Commit](<https://img.shields.io/github/last-commit/daemonless/actual?style=flat-square&amp;label=Last+Commit&amp;color=blue>)](<https://github.com/daemonless/actual/commits>) [![OCI Pulls](<https://img.shields.io/docker/pulls/daemonless/actual?style=flat-square&amp;label=OCI+Pulls&amp;color=blue>)](<https://hub.docker.com/r/daemonless/actual>)

Self-hosted personal finance sync server (Actual Budget) on FreeBSD.

[[![Actual Budget screenshot 1](<https://daemonless.io/images/screenshots/actual/demo.png>)](</images/screenshots/actual/demo.png>)](</images/screenshots/actual/demo.png>) [[![Actual Budget screenshot 2](<https://daemonless.io/images/screenshots/actual/screenshot_wide.png>)](</images/screenshots/actual/screenshot_wide.png>)](</images/screenshots/actual/screenshot_wide.png>)

|  |  |
| --- | --- |
| **Registry** | [`ghcr.io/daemonless/actual`](<https://github.com/daemonless/actual/pkgs/container/actual>) |
| **Daemonless** | [daemonless/actual](<https://github.com/daemonless/actual>) |
| **Source** | [actualbudget/actual](<https://github.com/actualbudget/actual>) |
| **Website** | [actualbudget.org](<https://actualbudget.org/>) |

## Prerequisites

Before deploying, ensure your host environment is ready. See the [Quick Start Guide](<https://daemonless.io/guides/quick-start/index.md>) for host setup instructions, including the security model for host vs. container privileges.

## Deployment

**Customize Paths, UID &amp; Ports**

Install and manage **Actual Budget** on FreeBSD with [fjord](<https://fjord.daemonless.io>):

```
fjord install actual
```

Or open the **App Store** in the fjord web UI and install **Actual Budget** from the wizard. New to fjord? See the [Install Guide](<https://fjord.daemonless.io/install/>).

```
services:
  actual:
    image: "ghcr.io/daemonless/actual:latest"
    container_name: actual
    environment:
      - PUID=1000  # User ID for the application process
      - PGID=1000  # Group ID for the application process
      - TZ=Etc/UTC  # Timezone for the container
      - NODE_ENV=production  # Node runtime mode; leave as 'production'
      - ACTUAL_PORT=5006  # Internal port the sync server listens on; leave as 5006
      - ACTUAL_HOSTNAME=0.0.0.0  # Bind address for the sync server; leave as 0.0.0.0 (the app's own default, '::', is IPv6-any and breaks single-stack containers)
      - ACTUAL_DATA_DIR=/data  # Directory where Actual stores its account database, budget files and server config (under the /data volume)
    volumes:
      - "/containers/actual/data:/data"
    # always (not unless-stopped) so FreeBSD's podman rc.d auto-starts it at boot
    restart: always
```

Save as `compose.yaml`, then run `podman-compose up -d`.

```
# .env

DIRECTOR_PROJECT=actual
PUID=1000
PGID=1000
TZ=Etc/UTC
NODE_ENV=production
ACTUAL_PORT=5006
ACTUAL_HOSTNAME=0.0.0.0
ACTUAL_DATA_DIR=/data
```

```
# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  actual:
    name: actual
    options:
      - container: 'args:--pull'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - NODE_ENV: !ENV '${NODE_ENV}'
        - ACTUAL_PORT: !ENV '${ACTUAL_PORT}'
        - ACTUAL_HOSTNAME: !ENV '${ACTUAL_HOSTNAME}'
        - ACTUAL_DATA_DIR: !ENV '${ACTUAL_DATA_DIR}'
    volumes:
      - actual_data: /data
volumes:
  actual_data:
    device: '/containers/actual/data'
```

```
# Makejail

ARG tag=latest

OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/actual:${tag}
```

Save the files above, then run `appjail-director up`.

> [!WARNING]
>
> **Experimental**
>
> Bastille's OCI support is experimental. It requires `buildah` and shares the host network stack (`inherit`). Mount volumes with `--volume HOST JAIL`; without it, image-declared volumes are stored under `${bastille_volumesdir}/${jail}`.

```
services:
  actual:
    name: actual
    image: "ghcr.io/daemonless/actual:latest"
    network:
      - mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - NODE_ENV=production
      - ACTUAL_PORT=5006
      - ACTUAL_HOSTNAME=0.0.0.0
      - ACTUAL_DATA_DIR=/data
    volumes:
      - "/containers/actual/data:/data"
```

Save as `bastille-compose.yml`, then run `bastille up`.

## Parameters

### Environment Variables

| Variable | Default | Description |
| --- | --- | --- |
| `PUID` | `1000` | User ID for the application process |
| `PGID` | `1000` | Group ID for the application process |
| `TZ` | `Etc/UTC` | Timezone for the container |
| `NODE_ENV` | `production` | Node runtime mode; leave as 'production' |
| `ACTUAL_PORT` | `5006` | Internal port the sync server listens on; leave as 5006 |
| `ACTUAL_HOSTNAME` | `0.0.0.0` | Bind address for the sync server; leave as 0.0.0.0 (the app's own default, '::', is IPv6-any and breaks single-stack containers) |
| `ACTUAL_DATA_DIR` | `/data` | Directory where Actual stores its account database, budget files and server config (under the /data volume) |

### Volumes

| Path | Description |
| --- | --- |
| `/data` | Application data — account database, budget files and server config |

## Version Tags

| Tag | Description | Best For |
| :--- | :--- | :--- |
| `latest` | **Upstream Binary**. Built from official release. | Most users — recommended. |

> [!NOTE]
>
> **Implementation Details**
>
> - **Architectures:** amd64
> - **User:** `bsd` (UID/GID set via [PUID/PGID](<https://daemonless.io/guides/permissions/index.md>)). Defaults to `1000:1000`.
> - **Base:** Built on `ghcr.io/daemonless/base` (FreeBSD 15).

---

Need help? Join our [Discord](<https://discord.gg/Kb9tkhecZT>) community.
