refactor: rewrite paisa_dev to match template conventions

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
code
2026-07-15 02:39:22 +00:00
co-authored by Claude Fable 5
parent f235038279
commit 40c8be5a57
4 changed files with 82 additions and 14 deletions
+60 -4
View File
@@ -2,7 +2,63 @@
## Overview
Docker Hub: https://hub.docker.com/r/ananthakumaran/paisa
Project: https://paisa.fyi/
Github: https://github.com/ananthakumaran/paisa
Proxy Port: 7500
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](https://github.com/ananthakumaran/paisa)
- **Container Image:** [Docker Hub](https://hub.docker.com/r/ananthakumaran/paisa)
- **Documentation:** [paisa.fyi](https://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
```bash
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
+19
View File
@@ -0,0 +1,19 @@
# Paisa Personal Finance Manager
services:
paisa:
image: ${PAISA_IMAGE:-ananthakumaran/paisa:latest}
restart: ${PAISA_RESTART:-unless-stopped}
volumes:
- ${VOL_PATH:-/data}/paisa:/root/Documents/paisa
ports:
- "${PAISA_PORT:-7500}:7500"
networks:
- proxy
networks:
proxy:
external: true
-6
View File
@@ -1,6 +0,0 @@
services:
paisa:
image: ${PAISA_IMAGE:-ananthakumaran/paisa:latest}
restart: unless-stopped
volumes:
- ${VOL_PATH:-./data}/paisa:/root/Documents/paisa/
+3 -4
View File
@@ -1,5 +1,4 @@
COOKBOOK=/git/docker-compose-cookbooks #HELP: cookbooks
VOL_PATH=./data/ #HELP: volpath
# Paisa
PAISA_IMAGE=ananthakumaran/paisa:latest
PAISA_RESTART=unless-stopped
VOL_PATH=/data
PAISA_PORT=7500