Skip to main content

​
Self-Hosting Overview

Run the entire Brainz Lab stack on your own infrastructure. All products are open source.

​
Why Self-Host?

Data Sovereignty

Keep all data on your own servers

Compliance

Meet regulatory requirements

Customization

Modify the code for your needs

No Limits

No usage limits or per-seat pricing

​
Deployment Options

OptionBest ForComplexity
Docker ComposeSmall teams, single serverEasy
KubernetesLarge scale, high availabilityAdvanced

​
Architecture

                         ┌─────────────────────────────────────┐
                         │        Traefik (Port 80)            │
                         └───────────────┬─────────────────────┘
                                         │
           ┌─────────────────────────────┼─────────────────────────┐
           │                             │                         │
           ▼                             ▼                         ▼
     ┌──────────┐               ┌──────────┐               ┌──────────┐
     │  Recall  │               │  Reflex  │               │  Pulse   │
     │  :3001   │               │  :3002   │               │  :3003   │
     └────┬─────┘               └────┬─────┘               └────┬─────┘
          │                          │                          │
          └──────────────────────────┼──────────────────────────┘
                                     │
                       ┌─────────────┴─────────────┐
                       │                           │
                  ┌────▼────┐                 ┌────▼────┐
                  │PostgreSQL│                │  Redis  │
                  │  :5432   │                │  :6379  │
                  └──────────┘                └─────────┘

​
Components

ComponentDescriptionPort
TraefikReverse proxy with subdomain routing80, 8080
RecallLog ingestion and query3001
ReflexError capture and management3002
PulseAPM and performance monitoring3003
PostgreSQLPrimary database5432
RedisCaching and queues6379

​
Requirements

​
Minimum

  • 4 CPU cores
  • 8 GB RAM
  • 50 GB storage
  • Docker 24+ or Kubernetes 1.28+
  • 8+ CPU cores
  • 16+ GB RAM
  • 200+ GB SSD storage
  • Kubernetes with auto-scaling

​
Quick Start

​
One-Line Install

curl -fsSL https://raw.githubusercontent.com/brainz-lab/stack/main/install.sh | bash

​
Manual Install

git clone https://github.com/brainz-lab/stack.git
cd stack
./scripts/setup.sh
./scripts/start.sh

​
Access Services

ServiceSubdomainDirect Port
Recallhttp://recall.localhosthttp://localhost:3001
Reflexhttp://reflex.localhosthttp://localhost:3002
Pulsehttp://pulse.localhosthttp://localhost:3003
Traefik Dashboard-http://localhost:8080

Docker Compose Guide

Full setup instructions

​
Docker Images

Images are published to both Docker Hub and GitHub Container Registry:
ServiceDocker HubGitHub
Recallbrainzllc/recallghcr.io/brainz-lab/recall
Reflexbrainzllc/reflexghcr.io/brainz-lab/reflex
Pulsebrainzllc/pulseghcr.io/brainz-lab/pulse

​
Source Code

All components are open source:
RepositoryDescription
brainz-lab/stackSelf-hosted deployment
brainz-lab/recallStructured logging
brainz-lab/reflexError tracking
brainz-lab/pulseAPM & performance

​
Support

Self-hosting is fully supported:
  • Community support via GitHub Discussions
  • Enterprise support available for paid plans
  • All documentation applies to self-hosted instances

​
Next Steps

Requirements

Detailed requirements

Docker Compose

Single-server setup

Kubernetes

Production-grade setup

Configuration

Environment variables