# Actual Budget Manager

> Actual Budget local-first personal finance app with sync server.

- Category: Productivity & Collaboration
- Difficulty: beginner
- Components: actual-server
- Tags: actual, budget, finance, ynab-alternative, local-first
- Source: https://docker.recipes/productivity/actual-budget

## Overview

Actual Budget is an open-source personal finance application that follows a local-first architecture, meaning your financial data stays on your device by default. Built as a modern alternative to You Need A Budget (YNAB), Actual Budget emerged from the need for privacy-focused budgeting software that doesn't require mandatory cloud subscriptions. The actual-server component provides the synchronization backend that enables data sharing across multiple devices while maintaining end-to-end encryption.

The actual-server acts as a sync hub for Actual Budget clients, storing encrypted budget files and coordinating changes between desktop, web, and mobile applications. Unlike traditional cloud-based budgeting apps, actual-server gives users complete control over their financial data location and access. The server handles conflict resolution when multiple devices modify budgets simultaneously and provides secure user authentication without exposing budget contents.

This configuration is ideal for privacy-conscious individuals and families who want YNAB-style envelope budgeting without recurring subscriptions or data privacy concerns. Financial advisors, small business owners, and anyone seeking granular control over their budgeting infrastructure will benefit from actual-server's self-hosted approach. The ability to import existing YNAB and Mint data makes it particularly valuable for users migrating from discontinued or expensive commercial alternatives.

## Features

- Zero-knowledge sync server that stores encrypted budget data without access to actual financial information
- Multi-device synchronization supporting desktop apps, web browsers, and mobile clients simultaneously
- Direct import compatibility with YNAB4, YNAB5, and Mint CSV exports for easy migration
- Envelope budgeting methodology with real-time balance tracking and overspending alerts
- Custom transaction categorization with rule-based automatic sorting and payee recognition
- Goal tracking for savings targets, debt paydown, and irregular expenses with timeline visualization
- Split transaction support for complex purchases across multiple budget categories
- Offline-first operation allowing full budget management without internet connectivity

## Use cases

- Privacy-focused families wanting shared budget access without cloud service dependencies
- Financial advisors managing multiple client budgets on controlled infrastructure
- YNAB refugees seeking feature parity without ongoing subscription costs
- Small business owners tracking personal and business finances on isolated networks
- Digital nomads requiring reliable budget sync across international internet connections
- Homelab enthusiasts integrating budgeting into personal cloud ecosystems
- Couples coordinating finances across different devices and operating systems

## Prerequisites

- Docker and Docker Compose installed on host system with container orchestration support
- Minimum 512MB available RAM for actual-server container and data processing
- Port 5006 available and not conflicting with existing web services
- Basic understanding of budget envelope methodology and transaction categorization
- Web browser supporting modern JavaScript for initial setup and administration
- Backup strategy for Docker volumes containing encrypted budget databases

## docker-compose.yml

```yaml
services:
  actual-server:
    image: actualbudget/actual-server:latest
    container_name: actual
    volumes:
      - actual_data:/data
    ports:
      - "5006:5006"
    restart: unless-stopped
    networks:
      - actual-network

volumes:
  actual_data:

networks:
  actual-network:
    driver: bridge
```

## .env

```bash
# Actual Budget
# No environment variables required for basic setup
```

## Usage notes

- UI at http://localhost:5006
- Create password on first visit
- Local-first with optional sync
- Import from YNAB, Mint
- End-to-end encrypted sync

## Troubleshooting

- Connection refused on port 5006: Verify container is running with 'docker ps' and check firewall rules blocking the port
- Password creation fails on first visit: Clear browser cache and cookies, ensure JavaScript is enabled for the domain
- Sync conflicts between devices: Stop all clients, restart actual-server container, then reconnect devices one at a time
- Import from YNAB fails with format error: Ensure exported file is unzipped CSV format, not the compressed .zip download
- Container exits immediately on startup: Check Docker logs with 'docker logs actual' for permission errors on /data volume mount
- Budget data appears corrupted after restart: Restore from Docker volume backup and verify filesystem integrity on host

