A comprehensive analytics and data management platform built with Next.js, TypeScript, and modern web technologies. Databuddy provides real-time analytics, user tracking, and data visualization capabilities for web applications.
- 📊 Real-time analytics dashboard
- 👥 User behavior tracking
- 📈 Advanced data visualization // Soon
- 🔒 Secure authentication
- 📱 Responsive design
- 🌐 Multi-tenant support
- 🔄 Real-time updates // Soon
- 📊 Custom metrics // Soon
- 🎯 Goal tracking
- 📈 Conversion analytics
- 🔍 Custom event tracking
- 📊 Funnel analysis
- 📈 Cohort analysis // Soon
- 🔄 A/B testing // Soon
- 📈 Export capabilities
- 🔒 GDPR compliance
- 🔐 Data encryption
- 📊 API access
- How do I get started? Follow the Getting Started guide.
- Bun 1.3.14+
- Node.js 20+
Databuddy can be self-hosted using Docker Compose. The repo includes two compose files:
| File | Purpose |
|---|---|
docker-compose.yaml | Development only — starts infrastructure (Postgres, ClickHouse, Redis) for local dev |
docker-compose.selfhost.yml | Production / self-hosting — backend services from GHCR images |
# 1. Configure environment
cp .env.example .env
# Edit .env — set IMAGE_TAG, URL-safe database/cache passwords, public URLs,# BETTER_AUTH_SECRET, DATABUDDY_ENCRYPTION_KEY, IP_HASH_SALT, and# AI_GATEWAY_API_KEY. Make the local database URLs use the same credentials# before running the initialization commands below.# 2. Start databases and cache
docker compose -f docker-compose.selfhost.yml up -d postgres clickhouse redis
# 3. Initialize databases from the repo checkout (first run only)
bun install --frozen-lockfile
bun run db:push
bun run clickhouse:init
# 4. Start backend services
docker compose -f docker-compose.selfhost.yml up -dServices started:
- API →
localhost:3001 - Basket (event ingestion) →
localhost:4000 - Insights (investigation worker) →
localhost:4002 - Links (short links) →
localhost:2500
All ports are configurable via env vars (API_PORT, BASKET_PORT, etc.). See the compose file comments for the full env var reference.
See CONTRIBUTING.md for guidelines.
See SECURITY.md for reporting vulnerabilities.
What is Databuddy? Databuddy is a comprehensive analytics and data management platform.
How do I get started? Follow the Getting Started guide.
Is it free? Check our pricing page.
What are the system requirements? See Prerequisites.
How do I deploy? See the deployment documentation in our docs.
How do I contribute? See Contributing.
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See the LICENSE file for details.
Copyright (c) 2025 Databuddy Analytics, Inc.