Self-Hosted · Open Source

BILLHIVE

Your household bills. Handled.

One person fronts every bill. Everyone else owes them money. BillHive tracks the splits, generates Zelle, Venmo & Cash App deep-links, and sends beautiful HTML email summaries — all from a single Docker container on your own server.

Wife owes
$1,287.50
Zelle · Venmo · Cash App ready
This month
Mortgage · Electric · Verizon
3 bills · $3,260 total
Dad covers Mom
$387.50
Verizon line — covered
1
Docker container
4
Email providers
Bills & People
$0
Subscription
Process

How BillHive works

From bill entry to payment collection in four steps. No SaaS account, no subscription — just your server.

01
📋
Add your bills
Create recurring bills and assign lines to household members. Choose percentage splits or fixed dollar amounts. Set "covered by" relationships for complex family arrangements.
02
✏️
Enter amounts
Each month, enter the actual bill totals. BillHive instantly calculates each person's share. Enable auto-carry for fixed bills like mortgage that don't change month to month.
03
💰
See who owes what
The Summary tab shows each person's total owed with a full bill-by-bill breakdown. Your personal outlay is tracked separately. Month-over-month charts show spending history.
04
📤
Collect payment
Send personalized HTML email summaries with one tap. Zelle, Venmo, and Cash App deep-links are auto-generated with the exact amount. A monthly checklist tracks what's been sent and collected.
Features

Everything you need

Built for real households with real complexity. Flexible enough to handle any bill arrangement you can imagine.

⚖️
Smart bill splitting
Split by percentage or fixed dollar amounts per line. Set "covered by" relationships — Dad can pay on Mom's behalf while Mom shows $0 owed.
💸
Payment deep-links
Zelle, Venmo, and Cash App links auto-generated with the exact amount pre-filled. Custom Zelle URLs supported for banks with their own enrollment flows.
📧
HTML email summaries
Beautiful dark-themed bill summaries sent to each person with one click. Supports Mailgun, SendGrid, Resend, and SMTP. API keys stay server-side, never exposed to the browser.
📈
Trend charts
Track spending month-over-month with line charts, donut breakdowns, and stacked bar charts. Two views: Per Person and By Bill. Powered by Chart.js.
Monthly checklist
Auto-generated checklist tracks what's been emailed, paid, and collected each month. Items are built dynamically from your configured people and bills.
🔒
Fully self-hosted
One Docker container. One SQLite database. One named volume. Deploy behind Authelia or Authentik for per-user data isolation. Your data never leaves your server.
App Preview

See it in action

The Bills tab — enter totals, see splits instantly across all household members. Every number updates live as you type.

🔒 bills.yourhome.local
February 2026
📋 Bills 3
💰 Summary
📤 Send & Receive
📈 Trends
⚙️ Settings
🏠
Mortgage
% split · auto-carry
$2,450.00
50% mine
🏠
Mortgage
Person
%
Amount
Me
50%
$1,225.00
Wife
50%
$1,225.00
📱
Verizon
fixed split · 4 lines
$320.00
4 people
Electric
% split · 3 lines
$185.00
30% mine
Wife
$1,287
Mortgage · Electric · Verizon
Dad
$387
Electric · Verizon (covers Mom)
Mom
$0
Covered by Dad · Verizon
BillHive iOS app — Bills tab
iOS Companion

BillHive in your pocket

The native iOS companion app connects directly to your self-hosted BillHive server. Same data, same splits, same email summaries — from your iPhone.

  • All five tabs — Bills, Summary, Send & Receive, Trends, Settings
  • Enter amounts and see splits update live as you type
  • Send HTML email summaries with one tap
  • Edit bill name, icon, and accent color directly in each card
  • Connects to your server URL — your data never leaves your hardware
View on GitHub
Self-Host

Deploy in minutes

BillHive ships as a single Docker image. No external database, no Redis, no cloud services. One command and you're running.

1

Pull and run the container

The image is published to GitHub Container Registry. A named volume persists your SQLite database across restarts.

2

Open in your browser

Navigate to http://localhost:8080. The app loads instantly — no login, no setup wizard.

3

Add people, add bills, done

Add household members in Settings. Name, icon, and color each bill directly on the Bills tab — then start entering monthly amounts immediately.

Multi-user? Deploy behind Authelia or Authentik. BillHive reads the Remote-User header and automatically scopes all data per user — safe for a shared household server.
Docker Run
latest
# Pull and run BillHive
docker run -d \
  --name billhive \
  -p 8080:8080 \
  -v billhive-data:/data \
  ghcr.io/martyportatoes/billflow:latest

docker-compose.yml
services:
  billhive:
    image: ghcr.io/martyportatoes/billflow:latest
    ports: ["8080:8080"]
    volumes: [billhive-data:/data]
    restart: unless-stopped
Node.js 20 SQLite WAL Express 4 Vanilla JS Alpine Linux ~50MB image