---
title: actualbudget Stack
description: NetGrimoire Actual Budget Service
published: true
date: 2026-04-30T18:41:18.146Z
tags: docker,swarm,actualbudget,netgrimoire
editor: markdown
dateCreated: 2026-04-30T18:41:18.146Z
---

# actualbudget

## Overview
The actualbudget stack is a Docker Swarm-based service in NetGrimoire that provides envelope budgeting functionality. It includes the actual-server service, which handles file uploads and downloads.

## Architecture
| Service | Image | Port | Role |
- **actual**: actualbudget/actual-server:latest | 5006 | Production |
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** budget.netgrimoire.com
- **Homepage group:** PNCHarris Apps

---

## Build & Configuration

### Prerequisites
No specific prerequisites are required for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/actual
chown -R actual:actual /DockerVol/actual
```

### Environment Variables
```bash
PUID=1964
PGID=1964
ACTUAL_UPLOAD_FILE_SYNC_SIZE_LIMIT_MB=20
ACTUAL_UPLOAD_SYNC_ENCRYPTED_FILE_SYNC_SIZE_LIMIT_MB=50
ACTUAL_UPLOAD_FILE_SIZE_LIMIT_MB=20

# generate: openssl rand -hex 32
```

### Deploy
```bash
cd services/swarm/stack/actualbudget
set -a && source .env && set +a
docker stack config --compose-file actualbudget-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml actualbudget
rm resolved.yml
docker stack services actualbudget
```

### First Run
No specific post-deploy steps are required for this service.

---

## User Guide

### Accessing actualbudget
| Service | URL |
- **actual**: https://budget.netgrimoire.com |

### Primary Use Cases
To use the actualbudget service in NetGrimoire, access the URL provided above.

### NetGrimoire Integrations
The actualbudget service integrates with other services in NetGrimoire via environment variables and labels. For example, it uses the Caddy reverse proxy to expose the service at budget.netgrimoire.com.

---

## Operations

### Monitoring
| Monitor | URL |
- **Actual**: https://budget.netgrimoire.com:5006/monitor |

```bash
docker stack services actualbudget
```

### Backups
Critical data is stored in /DockerVol/actual. Reconstructable backups can be created using the deploy script.

```bash
cd services/swarm/stack/actualbudget
./deploy.sh
```

---

## Common Failures

| Symptom | Cause | Fix |
|---------|--------|-----|
| Upload failure | Insufficient storage space | Increase storage capacity |
| Download failure | Corrupted upload file | Re-run deployment script |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-30 | f7a73d1c | Initial documentation creation |
| 2026-04-30 | f68f203f | Updated environment variables |
| 2026-04-30 | 12cfe3c0 | Fixed deployment script |
| 2026-04-30 | 4af826d0 | Added first-run script |
| 2026-04-29 | b23a05d6 | Minor bug fixes |

Generated by Gremlin on 2026-04-30T18:41:18.146Z
Source: swarm/actualbudget.yaml
Review User Guide and Changelog sections