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

1. How do I get started? Follow the Getting Started guide.

• Contributing
• Security
• FAQ
• Support
• License

• Bun 1.3.14+
• Node.js 20+

Databuddy can be self-hosted using Docker Compose. The repo includes two compose files:

# 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 -d

Services 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.

1. What is Databuddy? Databuddy is a comprehensive analytics and data management platform.

2. How do I get started? Follow the Getting Started guide.

3. Is it free? Check our pricing page.

1. What are the system requirements? See Prerequisites.

2. How do I deploy? See the deployment documentation in our docs.

3. How do I contribute? See Contributing.

• Documentation
• Discord
• Twitter
• GitHub Issues
• Email Support

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.