# Deploy DumbBudget with Easypanel

URL: /templates/dumbbudget

DumbBudget is a simple, self-hosted personal budgeting app from DumbWare.io. Track income and expenses with categories, PIN protection, multi-currency support, CSV export, and a responsive PWA UI. Data persists under /app/data.

## Installation notes

**BASE_URL** is set to your primary HTTPS domain—required for correct links and
auth behind a reverse proxy.
**DUMBBUDGET_PIN:** Leave the template default empty for open access (no PIN
gate), or set a PIN in the form / env to require it at login (see upstream
security notes on rate limits and lockouts).
**SITE_TITLE** appears in the UI header; **INSTANCE_NAME** is optional metadata
for multi-instance setups (matches upstream docker-compose).
**CURRENCY** must be a supported ISO code (see documentation link). After
deploy, open the app and complete any first-run prompts.


## Benefits

### Budget Management

Track income, expenses, and savings with intuitive budget management tools and financial insights.

### PIN Protection

Optional PIN-based access control for additional security and privacy protection of your financial data.

### Multi-Currency Support

Support for different currencies to match your local financial environment and preferences.

### Self-Hosted

Complete control over your financial data with no external dependencies or data sharing with third parties.

## Features

### Expense Tracking

Track and categorize your daily expenses and purchases.

### Income Management

Record and monitor your income sources and patterns.

### Budget Planning

Create and manage budgets for different categories.

### Financial Reports

Generate reports and insights about your spending habits.

### PIN Protection

Optional PIN-based access control for security.

### Multi-Currency

Support for different currencies and exchange rates.

### Data Persistence

All financial data persists across container restarts.

### Web Interface

Clean, responsive web interface for budget management.

## Configuration

- `appServiceName` (App Service Name, required): dumbbudget

- `appServiceImage` (App Service Image, required): dumbwareio/dumbbudget:b9db5cb32d14b7b78675d8be054611d4829253ef

- `dumbbudgetPin` (DUMBBUDGET_PIN, required): Set during installation — Optional. Empty = no PIN. Set a numeric PIN to protect the app at login.

- `currency` (Currency code, required): USD — ISO currency code (USD, EUR, GBP, …). See README for full supported list.

- `siteTitle` (SITE_TITLE, required): DumbBudget — Title shown in the app UI (upstream default DumbBudget).

- `instanceName` (INSTANCE_NAME, required): Set during installation — Optional label for this instance/account when running multiple deployments.

## Services

- dumbbudget: app (dumbwareio/dumbbudget:b9db5cb32d14b7b78675d8be054611d4829253ef)

## Resources

- [Website](https://dumbware.io)

- [Documentation](https://github.com/dumbwareio/dumbbudget/blob/main/README.md)

- [GitHub](https://github.com/dumbwareio/dumbbudget)

- [Docker Hub](https://hub.docker.com/r/dumbwareio/dumbbudget)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/dumbbudget)