Skip to main content

Take Control of Your Finances with Budgetron

A privacy-focused, self-hosted budgeting app with AI-powered transaction categorization. Built with Next.js, PostgreSQL, and modern web technologies.

Get StartedAPI Reference

Quick Start

Get Budgetron up and running in minutes with Docker or self-hosted deployment

1

Clone the Repository

Clone the Budgetron repository from GitHub to your local machine.
git clone https://github.com/budgetron-org/budgetron.git
cd budgetron
2

Configure Environment Variables

Copy the example environment file and configure your database, authentication, and optional services.
cp .env.example .env
At minimum, set these required variables:
  • DB_URL - PostgreSQL connection string
  • AUTH_SECRET - Secret for JWT session encryption
  • AUTH_URL - Your app’s public URL
See the Environment Variables guide for all available options.
3

Start with Docker

The easiest way to run Budgetron is using Docker:
docker build -t budgetron .
docker run -p 3000:3000 --env-file .env budgetron
The container will automatically wait for the database, run migrations, and start the application.
4

Access Your Dashboard

Open your browser and navigate to http://localhost:3000 to access Budgetron. Create an account and start managing your budget!
For production deployments, check out our Production Guide for best practices.

Core Features

Everything you need to manage your personal finances

Budget Management

Create and track budgets across multiple categories with real-time spending insights and alerts.

AI Categorization

Automatically categorize transactions using local LLMs or OpenAI-compatible APIs for intelligent expense tracking.

Multi-Account Support

Manage multiple bank accounts and track transactions across all your financial accounts in one place.

Reports & Analytics

Visualize cash flow, category breakdowns, and spending trends with interactive charts and reports.

Transaction Import

Import transactions from OFX files or manually add them with a clean, intuitive interface.

Privacy-First

Self-host on your own infrastructure with complete control over your financial data.

Technology Stack

Built with modern, production-ready technologies

Frontend

  • • Next.js 14+ App Router
  • • React 19 with TypeScript
  • • Tailwind CSS + shadcn/ui
  • • TanStack Query & Forms

Backend

  • • PostgreSQL Database
  • • Drizzle ORM
  • • oRPC for type-safe APIs
  • • BetterAuth

Infrastructure

  • • Docker & Docker Compose
  • • Vercel Blob Storage
  • • Email via Resend
  • • AI via Ollama/OpenAI

Explore the Documentation

Deep dive into configuration, deployment, and development

Configuration Guide

Learn how to configure authentication, database connections, AI providers, email services, and more.

Configure your app

Deployment Options

Deploy Budgetron with Docker, on your own infrastructure, or in production environments.

Deployment guides

Development Guide

Set up your local development environment and learn about the project architecture.

Start developing

API Reference

Explore the complete API reference for programmatic access to Budgetron features.

Browse API docs

Ready to Take Control of Your Budget?

Start managing your finances with privacy, control, and intelligent AI-powered insights.

Get Started NowView on GitHub

Build docs developers (and LLMs) love

Get started for freeTalk to us