Prerequisites

Docker(20.10+)

Docker Compose(2.0+)

Installation Steps

1. Clone the repository

git clone https://github.com/b2alabs/b2alabs.git
cd b2alabs

2. Configure environment variables (optional)

cp .env.example .env
# Edit .env with your configuration
nano .env

3. Start all services

docker-compose up -d

4. Verify services are running

docker-compose ps

5. Apply database migrations

cd packages/gateway-core
make migrate-up

6. Access the services

• Web Dashboard: http://localhost:3000
• Gateway API: http://localhost:8080
• Grafana: http://localhost:3001 (admin/admin)

Management Commands

# Stop services
docker-compose down

# Restart services
docker-compose restart

# View logs
docker-compose logs -f gateway

# Clean restart (removes volumes)
docker-compose down -v
docker-compose up -d

Prerequisites

Kubernetes(1.30+)

Helm(3.14+)

kubectl(latest)

Installation Options

Option 1: From Helm Repository (Recommended)

# Add Helm repository (when published)
helm repo add b2alabs https://helm.b2alabs.com
helm repo update

# Install
helm install b2alabs b2alabs/b2alabs \
  --namespace b2alabs \
  --create-namespace

Option 2: From Source

# Clone repository
git clone https://github.com/b2alabs/b2alabs.git
cd b2alabs

# Install with Helm
helm install b2alabs ./infrastructure/helm/b2alabs \
  --namespace b2alabs \
  --create-namespace

Option 3: With Custom Values

# Create values file
cat > values.yaml <<EOF
gateway:
  replicaCount: 3
  image:
    tag: v1.0.0
web:
  replicaCount: 2
ingress:
  enabled: true
  hosts:
    - host: api.yourdomain.com
EOF

# Install
helm install b2alabs b2alabs/b2alabs \
  -f values.yaml \
  --namespace b2alabs \
  --create-namespace

Verify Installation

# CheckIcon pod status
kubectl get pods -n b2alabs

# CheckIcon services
kubectl get services -n b2alabs

# CheckIcon ingress
kubectl get ingress -n b2alabs

# Test health endpoint
curl http://<your-domain>/health

Management Commands

# Upgrade
helm upgrade b2alabs b2alabs/b2alabs -n b2alabs

# Rollback
helm rollback b2alabs -n b2alabs

# Uninstall
helm uninstall b2alabs -n b2alabs

# View logs
kubectl logs -f deployment/b2alabs-gateway -n b2alabs

Prerequisites

Go(1.23+)

Node.js(22+)

pnpm(9.0+)

PostgreSQL(16+)

Redis(7+)

Build Gateway (Go)

cd packages/gateway-core

# Install dependencies
go mod download

# Build
make build

# Run
./gateway

Build Web Platform (Next.js)

cd packages/web-platform

# Install dependencies
pnpm install

# Build
pnpm build

# Run
pnpm start

Development Mode

# Gateway (with hot reload)
cd packages/gateway-core
make dev

# Web Platform (with hot reload)
cd packages/web-platform
pnpm dev

Running Tests

# Gateway tests
cd packages/gateway-core
make test

# Web Platform tests
cd packages/web-platform
pnpm test

# E2E tests
pnpm test:e2e

Amazon Web Services (AWS)

Recommended managed services:

EKS (Kubernetes)
RDS (PostgreSQL)
ElastiCache (Redis)
ALB (Load Balancer)

Google Cloud Platform (GCP)

Recommended managed services:

GKE (Kubernetes)
Cloud SQL (PostgreSQL)
Memorystore (Redis)
Cloud Load Balancing

Microsoft Azure

Recommended managed services:

AKS (Kubernetes)
Azure CircleStackIcon (PostgreSQL)
Azure Cache (Redis)
Azure Load Balancer

Cloud Deployment Note

All cloud providers support Kubernetes, making it easy to use the same Helm charts. The main differences are in managed service configurations (databases, caching, load balancers).

Installation Guide

Just Want to Try It?

Docker Compose Installation

Prerequisites

Installation Steps

Management Commands

Kubernetes with Helm

Prerequisites

Installation Options

Verify Installation

Management Commands

Build from Source

Prerequisites

Build Gateway (Go)

Build Web Platform (Next.js)

Development Mode

Running Tests

Cloud Provider Deployments

Amazon Web Services (AWS)

Google Cloud Platform (GCP)

Microsoft Azure

What's Next?

Configuration

Getting Started

Authentication

Production Deployment

Need Help with Installation?