selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
DumbBudget logo

Self-host DumbBudget

PIN-protected budgeting app for personal finance

BetaOpen SourceGPL-3.0
Updated11 months ago
LanguageJavaScript
Setup difficultyEasy
MobilePWA
ThemeDark mode
Stars
343
Port
3000 (HTTP server)
Docker
dumbwareio/dumbbudget
DumbBudget main interface showing transaction list and balance

What is DumbBudget?

DumbBudget is a simple, secure personal budgeting application designed for self-hosting. It provides PIN-protected access to track income and expenses with real-time balance calculations, transaction categorization, date range filtering, and sorting by date or amount. The app supports over 25 currencies, exports data to CSV, and works as a Progressive Web App with responsive design and light/dark themes. It runs as a Node.js application in a Docker container, storing transaction data in a mounted volume. Configuration is done via environment variables including a required PIN code, optional currency, base URL, and site title. The project is licensed under GPL-3.0 and accepts donations via Buy Me A Coffee.

Should you self-host DumbBudget?

DumbBudget scores 46/100 on selfhost.directory (how scoring works) and ranks #34 of 62 in Personal Finance. It has 343 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Firefly III (82/100, 25 023 stars). It scores higher overall, so compare the two before you pick. See DumbBudget vs Firefly III side by side.

Features

  • CSV Export
  • Date range filtering
  • Income and expense tracking
  • Multi-currency Support
  • PIN-protected access
  • Progressive Web App
  • Rate limiting on PIN attempts
  • Real-time balance calculations
  • Secure session handling
  • Sorting by date or amount
  • Temporary lockout after failed attempts
  • Transaction Categorization
  • Transaction type filtering

DumbBudget README

How to configure DumbBudget

  • ALLOWED_ORIGINS*Restrict origins for CORS

    Restrict origins for CORS

    values: Comma-separated list of origins

  • BASE_URLhttp://localhost:PORTBase URL for the application

    Base URL for the application

    values: Any valid URL

  • CURRENCYUSDCurrency code for transactions

    Currency code for transactions

    values: USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY, HKD, NZD, MXN, RUB, SGD, KRW, INR, BRL, ZAR, TRY, PLN, SEK, NOK, DKK, IDR, PKR

  • DUMBBUDGET_PINPIN code for accessing the application

    PIN code for accessing the application

    values: Any numeric PIN

  • INSTANCE_NAMEName of instance/account

    Name of instance/account

    values: Any string

  • PORT3000Port number for the server

    Port number for the server

    values: Any valid port number

  • SITE_TITLEAllows you to name each instance should you have multiple

    Allows you to name each instance should you have multiple

    values: Any string

More in Personal Finance

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…