docker-compose-cookbooks/paisa_dev/README.md

Paisa

Overview

Paisa is a self-hosted personal finance manager built on top of the plain-text ledger accounting format, with a web UI for dashboards, budgets, and transaction management.

Project Details

• Project Repository: github.com/ananthakumaran/paisa
• Container Image: Docker Hub
• Documentation: paisa.fyi
• Reverse Proxy Port: 7500

Getting Started

1. Start the container: docker compose up -d
2. Open http://localhost:7500 in your browser
3. Configure your ledger journal and accounts via the web UI

Environment Variable Notes

PAISA_IMAGE – container image (default ananthakumaran/paisa:latest)
PAISA_RESTART – restart policy (default unless-stopped)
VOL_PATH – host base path for volumes (default /data)
PAISA_PORT – host port for the web UI (default 7500)

Volume Notes

• /root/Documents/paisa — ledger journal, config, and database; stored at ${VOL_PATH:-/data}/paisa on the host

Network Notes

Requires proxy network

Docker Run

docker run -d \
  --name=paisa \
  -p 7500:7500 \
  -v /data/paisa:/root/Documents/paisa \
  ananthakumaran/paisa:latest

Additional Notes / Gotchas

• This is a _dev stack — experimental, not yet production-ready.
• The container runs as root and stores everything under /root/Documents/paisa; back up that directory to preserve your ledger data.

Dockhand Stack, Deploy from Git

• Cookbooks Repository
• stackname: paisa_dev
• Compose file path: paisa_dev/compose.yaml
• Additional env file (optional): paisa_dev/sample.env

Then "Load" paisa_dev/sample.env into the Environment variables in dockhand.

Create the Stack