Getting Started

Prerequisites

Node.js 20+ and npm
PostgreSQL 15+ (or use Docker)
S3-compatible storage (optional, for file uploads)

Installation

git clone https://github.com/dubbl-org/dubbl.git
cd dubbl
pnpm install

Environment Variables

cp .env.example .env

Edit .env with your configuration:

.env

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/dubbl

# Auth
AUTH_SECRET=your-random-secret-here
AUTH_URL=http://localhost:3000

# Stripe (optional)
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# S3 Storage (optional)
S3_BUCKET=dubbl-uploads
S3_REGION=us-east-1
S3_ACCESS_KEY_ID=...
S3_SECRET_ACCESS_KEY=...
S3_ENDPOINT=https://s3.amazonaws.com

Database Setup

pnpm db:push

pnpm db:push
pnpm db:seed

Start Development

pnpm dev

Open http://localhost:3000 in your browser.

If you ran the seed script, log in with [email protected] / password123. This gives you a fully populated demo organization with chart of accounts, contacts, invoices, bills, bank accounts, projects, and more.

Next Steps

Self-Hosting Guide - Deploy to production with Docker
Chart of Accounts - Set up your accounts
Invoicing - Create and send invoices
Accounting Concepts - Learn double-entry basics