OttoChain Deploy

Single source of truth for OttoChain deployment infrastructure.

Architecture

┌───────────────┐  ┌───────────────┐  ┌───────────────┐  ┌───────────────┐
│ ottochain     │  │ ottochain-    │  │ ottochain-    │  │ ottochain-    │
│ (metagraph)   │  │ services      │  │ explorer      │  │ monitoring    │
│               │  │               │  │               │  │               │
│ CI → JAR      │  │ CI → ghcr.io  │  │ CI → ghcr.io  │  │ Configs only  │
└───────┬───────┘  └───────┬───────┘  └───────┬───────┘  └───────┬───────┘
        │                  │                  │                  │
        └──────────────────┴──────────────────┴──────────────────┘
                                    │
                       ┌────────────▼────────────┐
                       │   ottochain-deploy      │
                       │                         │
                       │   versions.yml          │
                       │   compose/*.yml         │
                       │   envs/*.env            │
                       │                         │
                       │   CD → target env       │
                       └─────────────────────────┘

Quick Start

# Clone deploy repo
git clone https://github.com/ottobot-ai/ottochain-deploy.git
cd ottochain-deploy

# Clone monitoring repo (required for monitoring stack)
git clone https://github.com/ottobot-ai/ottochain-monitoring.git ../ottochain-monitoring

# Set up environment
cp envs/local.env .env

# Create networks
make network

# Start services
make services

# View status
make ps

Compose Layers

Layer	File	Services
Base	compose/base.yml	Redis, Postgres
Services	compose/services.yml	Gateway, Bridge, Indexer, Monitor
Explorer	compose/explorer.yml	React frontend
Monitoring	compose/monitoring.yml	Prometheus, Alertmanager, Grafana
Exporters	compose/exporters.yml	node-exporter, postgres-exporter, redis-exporter
Logging	compose/logging.yml	Loki, Promtail
Traffic	compose/traffic.yml	Traffic generator (testing)
Metagraph	compose/metagraph.yml	GL0, GL1, ML0, CL1, DL1 (5-layer stack)

Usage

Development

# Just services (most common)
make services

# With monitoring
make full

# With log aggregation
make full-logging

Manual Compose

# Layer files as needed
docker compose \
  -f compose/base.yml \
  -f compose/services.yml \
  -f compose/monitoring.yml \
  up -d

Metagraph Deployment

# Genesis node (first node)
NODE_IP=1.2.3.4 make metagraph-genesis

# Validator nodes (subsequent nodes)
NODE_IP=1.2.3.5 GENESIS_IP=1.2.3.4 make metagraph-validator

Commands

make help           # Show all commands
make up             # Start services (alias)
make down           # Stop everything
make logs           # Follow all logs
make logs SERVICES='gateway indexer'  # Filter logs
make ps             # List containers
make clean          # Stop + remove volumes

Environments

File	Purpose
envs/local.env	Local development (Docker Desktop)
envs/testnet.env	Hetzner testnet cluster
envs/prod.env.template	Production template (copy & fill)

# Switch environments
cp envs/testnet.env .env
# Edit .env to set passwords
make services

Version Management

versions.yml pins all component versions:

images:
  services: ghcr.io/ottobot-ai/ottochain-services:v1.2.3
  explorer: ghcr.io/ottobot-ai/ottochain-explorer:v1.0.0

jars:
  tessellation: "2.10.1"
  ottochain: "0.5.0"

To update a version:

1. Edit versions.yml
2. Run make pull to fetch new images
3. Run make up to deploy

Directory Structure

ottochain-deploy/
├── compose/                 # Layered compose files
│   ├── base.yml             # Redis, Postgres
│   ├── services.yml         # Gateway, Bridge, Indexer, Monitor
│   ├── explorer.yml         # React frontend
│   ├── metagraph.yml        # 5-layer Tessellation stack
│   ├── monitoring.yml       # References ottochain-monitoring repo
│   ├── exporters.yml        # Metric exporters
│   ├── logging.yml          # Loki, Promtail
│   └── traffic.yml          # Traffic generator
├── envs/                    # Environment configs
│   ├── local.env
│   ├── testnet.env
│   └── prod.env.template
├── scripts/                 # Deployment scripts
├── docker/                  # Metagraph Dockerfiles
├── versions.yml             # Component version pins
├── Makefile                 # Convenience commands
└── .env                     # Active environment (gitignored)

# Sibling repo (clone alongside):
../ottochain-monitoring/     # Prometheus, Grafana, Alertmanager configs

Ports

Service	Port
Gateway	4000
Bridge	3030
Indexer	3031
Monitor	3032
Explorer	8080
Postgres	5432
Redis	6379
Prometheus	9090
Alertmanager	9093
Grafana	3000
Loki	3100
GL0	9000
GL1	9100
ML0	9200
CL1	9300
DL1	9400

Repository Structure

Each repo is independently deployable:

# Run any repo standalone
cd ottochain-services && docker compose up -d
cd ottochain-explorer && docker compose up -d
cd ottochain-monitoring && docker compose up -d

# Or use deploy to orchestrate all together
cd ottochain-deploy && make full

Related Repositories

Repo	Purpose	Standalone?
ottochain	Metagraph (Scala)	✅ just up
ottochain-services	Gateway, Bridge, Indexer	✅ docker compose up
ottochain-explorer	React frontend	✅ docker compose up
ottochain-monitoring	Prometheus, Grafana	✅ docker compose up
ottochain-sdk	TypeScript SDK	N/A (library)
ottochain-deploy	Orchestration	Combines all above