Deployments

BigBrotr ships with two deployment configurations that demonstrate different use cases. Both use the same codebase and all six services.

Deployment Structure

deployments/
├── Dockerfile              # Shared parametric Dockerfile
├── bigbrotr/               # Full deployment
│   ├── docker-compose.yaml
│   ├── .env.example
│   ├── config/
│   │   ├── brotr.yaml
│   │   └── services/*.yaml
│   ├── postgres/
│   │   └── init/*.sql      # 10 SQL files, 25 stored functions
│   ├── pgbouncer/
│   │   └── pgbouncer.ini
│   └── monitoring/
│       ├── prometheus/
│       └── grafana/
└── lilbrotr/               # Lightweight deployment
    ├── docker-compose.yaml
    ├── .env.example
    ├── config/
    ├── postgres/
    ├── pgbouncer/
    └── monitoring/

BigBrotr

The full deployment for comprehensive Nostr network observation.

• All six services with full configuration
• All 11 materialized views
• PostgreSQL with PgBouncer (transaction mode)
• Prometheus metrics collection with 6 alert rules
• Grafana dashboards with service overview
• Docker Compose with resource limits and health checks
• Two Docker networks: data (services + database) and monitoring

Docker Compose Services

Service	Image	Purpose
postgres	PostgreSQL 16	Database with schema initialization
pgbouncer	PgBouncer	Connection pooling (transaction mode)
prometheus	Prometheus	Metrics collection and alerting
grafana	Grafana	Monitoring dashboards

PgBouncer Configuration

Two connection pools:

Pool	Users	Pool Size	Purpose
bigbrotr	writer	10	All six services
bigbrotr_readonly	reader	8	API, DVM, monitoring

LilBrotr

A lightweight deployment with the same architecture, demonstrating BigBrotr’s customizability.

• Same six services and all 11 materialized views
• Smaller batch sizes and longer sleep intervals
• Lower resource limits
• Same monitoring stack

The key difference is configuration tuning, not code changes. LilBrotr processes less data per cycle but uses the same codebase.

Parametric Dockerfile

Both deployments share a single Dockerfile:

ARG DEPLOYMENT
# ... builds for the specified deployment

Build with:

docker build --build-arg DEPLOYMENT=bigbrotr -t bigbrotr .
docker build --build-arg DEPLOYMENT=lilbrotr -t lilbrotr .

Environment Variables

Both deployments use .env files for secrets and runtime configuration:

Variable	Description
POSTGRES_USER	PostgreSQL superuser
POSTGRES_PASSWORD	Superuser password
POSTGRES_DB	Database name
WRITER_USER	Writer services user
WRITER_PASSWORD	Writer password
READER_USER	Read-only user
READER_PASSWORD	Reader password
NOSTR_PRIVATE_KEY	Monitor event publishing key (optional)

Creating Your Own Deployment

To create a custom deployment:

1. Copy an existing deployment directory.
2. Modify config/brotr.yaml for your database settings.
3. Adjust config/services/*.yaml for your batch sizes and intervals.
4. Update .env.example with your database name and credentials.
5. Modify pgbouncer/pgbouncer.ini with your pool names.
6. Build with --build-arg DEPLOYMENT=yourdeployment.

Next Steps

• Quick Start — get a deployment running.
• Core Configuration — detailed config parameters.