lukevinskywynn/envelopes repository overview

⁠Envelopes

Self-hosted envelope budgeting inspired by YNAB and Monarch. Take full control of your finances — no subscriptions, no data sharing, runs entirely on your own hardware.

⁠Quick Start

services:
  envelopes:
    image: lukevinskywynn/envelopes:latest
    container_name: envelopes
    restart: unless-stopped
    ports:
      - "4321:4321"
    environment:
      - JWT_SECRET=your-random-secret-here
      - ENVELOPES_USERNAME=admin
      - ENVELOPES_PASSWORD=your-secure-password
    volumes:
      - envelopes_data:/app/data

volumes:
  envelopes_data:

Open http://your-server:4321 and log in with the credentials you set above.

⁠Environment Variables

⁠Features

• Envelope Budgeting — Give every dollar a job. Assign income to categories each month.
• Dashboard — Net worth, assets, liabilities, monthly savings at a glance.
• All Account Types — Checking, savings, credit cards, mortgages, auto loans, investments, CDs, retirement.
• Transaction Tracking — Log income and expenses with categories and payees.
• Spending Reports — Pie charts and bar charts broken down by category.
• Income vs Expenses — Monthly trend chart with net savings tracking.
• Debt Payoff Planner — Avalanche vs snowball comparison with payoff timeline and interest savings.
• Goal Tracking — Set savings targets, track progress, quick-add contributions.
• 100% Private — Your data never leaves your server.

⁠Updating

docker pull lukevinskywynn/envelopes:latest
docker compose up -d

Data is stored in the named volume and persists across updates.

⁠Source & Issues

GitHub: github.com/kevin-wynn/envelopes⁠

MIT License