Nomploy Nomad Packs

← All packs

actual v0.1.0

Apps

Actual Budget — a fast, privacy-focused, local-first personal finance / envelope-budgeting app with a self-hosted sync server. Deployed as a host-networked Nomad service with a persistent volume for your budget data.

nomad-pack run actual --registry nomploy

Source ↗ Project ↗ ★ 29.1k

2 tasks http 5006 1 volume image actualbudget/actual-server:latest
Variables 8
values.hcl

Save as values.hcl, edit, then run:

nomad-pack run actual -f values.hcl --registry nomploy
# The name of the Nomad job.
job_name = "actual"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The Actual Budget server container image. Pin a tag in production.
image = "actualbudget/actual-server:latest"

# Host port for the Actual web app / sync server (ACTUAL_PORT).
port = 5006

# Docker named volume for /data (the budget files + server DB). A prestart task chowns it to uid 1000 (the node user). Back it up.
data_volume = "actual_data"

# Placement constraints — pin to one node so the local volume stays put. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# The task resources.
resources = {
    cpu    = 300
    memory = 256
  }
NameTypeDefaultDescription
job_name string 
"actual"
 The name of the Nomad job.
namespace string 
"default"
 The Nomad namespace to deploy into.
datacenters list 
["*"]
 The datacenters to deploy to.
image string 
"actualbudget/actual-server:latest"
 The Actual Budget server container image. Pin a tag in production.
port number 
5006
 Host port for the Actual web app / sync server (ACTUAL_PORT).
data_volume string 
"actual_data"
 Docker named volume for /data (the budget files + server DB). A prestart task chowns it to uid 1000 (the node user). Back it up.
constraints list 
[]
 Placement constraints — pin to one node so the local volume stays put. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources object 
{
    cpu    = 300
    memory = 256
  }
 The task resources.
Readme

actual

Actual Budget — a fast, privacy-focused, local-first personal finance app (zero-based / envelope budgeting) with a self-hosted sync server. Your data lives on your server and syncs to the web, desktop, and mobile apps. Host-networked Nomad service with a persistent volume.

Usage

nomad-pack registry add nomploy github.com/Nomploy/nomad-packs
nomad-pack run actual --registry nomploy

In nomploy: create a Compose service, type Nomad Pack, pack actual, custom registry github.com/Nomploy/nomad-packs, then Deploy. Open http://<node-ip>:5006, set a server password on first visit, and create your budget.

Key variables

Variable Default Notes
image actualbudget/actual-server:latest Pin a tag in production.
port 5006 Web app / sync server (ACTUAL_PORT).
data_volume actual_data Budgets + sync DB. Back it up.
constraints [] Pin to a node so the local volume stays put.
resources cpu 300 / mem 256 Lightweight.

Notes