javiocu/actualbudget-qnap-32k repository overview

⁠Actual Budget for QNAP NAS (ARMv7 - 32KB Page Size)

Custom-built Actual Budget v26.2.0 image for QNAP NAS devices with ARMv7 CPUs and 32KB memory page size (e.g., TS-431P3 with Annapurna Labs AL314).

⁠Why This Image?

Official Actual Budget images crash on certain QNAP NAS models with:

ELF load command address/offset not page-aligned

This image fixes the issue by recompiling better-sqlite3 with the correct memory alignment flag for 32KB page size kernels.

⁠Supported Hardware

✅ Tested: QNAP TS-431P3 (Alpine AL314 CPU)
⚠️ Possible compatibility: TS-431P2, TS-231P3, and other ARMv7 QNAP NAS with 32KB pages

⁠Quick Start

⁠Docker Compose (Recommended)

services:
  actual-budget:
    image: javiocu/actualbudget-qnap-32k:latest
    container_name: actual-budget
    restart: unless-stopped
    ports:
      - "5006:5006"
    volumes:
      - /share/Container/actual-data:/data
    environment:
      - TZ=Europe/Madrid

Deploy:

cd /share/Container/actual-budget
mkdir -p /share/Container/actual-data
docker-compose up -d

Access at: http://your-nas-ip:5006

⁠HTTPS Setup (Optional)

For full functionality, use QNAP's reverse proxy:

1. Control Panel → Security → Reverse Proxy
2. Create rule: HTTPS:5007 → HTTP:localhost:5006
3. Add custom headers:

   Cross-Origin-Opener-Policy: same-origin
   Cross-Origin-Embedder-Policy: require-corp
   

   Copy

Access at: https://your-nas-ip:5007

⁠What's New in v26.2.0

• Multiple dashboard pages for organizing reports
• Budget analysis report (track categories over time)
• Custom color themes
• Improved mobile performance
• Search/replace with RegEx in notes

Full release notes⁠

⁠Backup

# Backup your data
tar -czf actual-backup-$(date +%Y%m%d).tar.gz /share/Container/actual-data/

Budget files are stored in /data - back them up regularly!

⁠Troubleshooting

"SharedArrayBuffer not available" error:

• Use HTTPS with reverse proxy (see above)
• Or click "Advanced Options → Enable Fallback Mode"

Container won't start:

docker logs actual-budget
# Check folder permissions
chown -R 1000:1000 /share/Container/actual-data

⁠Available Tags

• latest - Most recent build
• 26.2.0 - Specific version

⁠Technical Details

• Base: Debian Bullseye + Node 18
• Fix: better-sqlite3 recompiled with -Wl,-z,max-page-size=32768
• Architecture: linux/arm/v7

⁠License

Unofficial build of Actual Budget⁠ (MIT License) for QNAP compatibility.

Not affiliated with or endorsed by Actual Budget maintainers.

Search for more images with page 32k problems in QNAP in my Github⁠

Questions? Actual Budget Discord⁠ | Official Docs⁠