Deployment Overview

Guides for deploying NCN Network in different environments.

---

Deployment Options

Option	Best For	Complexity
Docker Compose	Development, testing	Low
Manual	Custom setups	Medium
Kubernetes	Production, scale	High

---

Quick Comparison

Docker Compose

# Quick start
docker-compose up -d

Pros:

• Easiest setup

• Good for development

• All services orchestrated

Cons:

• Single machine only

• Limited scaling

Manual Deployment

# Build and run each component
cargo build --release
./target/release/gateway_node &
./target/release/compute_node &
./target/release/p2p_registry_node &

Pros:

• Full control

• Custom configuration

Cons:

• More setup work

• Manual orchestration

Kubernetes

# Deploy with Helm
helm install ncn ./charts/ncn

Pros:

• Production ready

• Auto-scaling

• High availability

Cons:

• Complex setup

• Kubernetes knowledge required

---

Deployment Guides

Docker

Container-based deployment:

• Prerequisites

• Docker Compose setup

• Configuration

• Monitoring

• Troubleshooting

Manual

Manual deployment on bare metal or VMs:

• System requirements

• Building from source

• Service configuration

• Process management

Kubernetes

Production deployment on K8s:

• Helm charts

• Resource configuration

• Scaling

• Monitoring

Production

Production considerations:

• Security hardening

• High availability

• Backup/recovery

• Monitoring & alerting

---

Architecture by Deployment Type

Development (Single Machine)

┌─────────────────────────────────────────────────────────────────────────────┐
│                         Single Machine                                       │
│                                                                             │
│   ┌───────────────┐   ┌───────────────┐   ┌───────────────┐                │
│   │   Registry    │   │    Gateway    │   │   Compute     │                │
│   │   :50050      │   │  :50051/:8080 │   │               │                │
│   └───────────────┘   └───────────────┘   └───────────────┘                │
│                                                                             │
│   ┌───────────────────────────────────────────────────────────────────────┐│
│   │                    Local Blockchain (Anvil)                            ││
│   └───────────────────────────────────────────────────────────────────────┘│
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

Production (Distributed)

┌─────────────────────────────────────────────────────────────────────────────┐
│                         Distributed Setup                                    │
│                                                                             │
│   Load Balancer                                                             │
│   ┌───────────────────────────────────────────────────────────────────────┐│
│   │                           HAProxy/NGINX                                ││
│   └───────────────────────────────────┬───────────────────────────────────┘│
│                                       │                                     │
│   Gateway Cluster                     │                                     │
│   ┌───────────────┐   ┌───────────────▼───┐   ┌───────────────┐            │
│   │  Gateway 1    │   │    Gateway 2      │   │   Gateway 3   │            │
│   └───────────────┘   └───────────────────┘   └───────────────┘            │
│           │                   │                       │                     │
│           └───────────────────┼───────────────────────┘                     │
│                               │                                             │
│   Registry Cluster            │                                             │
│   ┌───────────────┐   ┌───────▼───────────┐   ┌───────────────┐            │
│   │  Registry 1   │◀──│    Registry 2     │──▶│  Registry 3   │            │
│   └───────────────┘   └───────────────────┘   └───────────────┘            │
│                               │                                             │
│   Compute Pool                │                                             │
│   ┌───────────────┐   ┌───────▼───────────┐   ┌───────────────┐            │
│   │  Compute 1    │   │    Compute 2      │   │   Compute N   │            │
│   │  (GPU)        │   │    (GPU)          │   │   (GPU)       │            │
│   └───────────────┘   └───────────────────┘   └───────────────┘            │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

---

Prerequisites by Role

Gateway Server

Resource	Minimum	Recommended
CPU	2 cores	4 cores
RAM	4 GB	8 GB
Storage	50 GB SSD	100 GB SSD
Network	100 Mbps	1 Gbps

Compute Server

Resource	Minimum	Recommended
CPU	4 cores	8+ cores
RAM	8 GB	32+ GB
GPU	Optional	NVIDIA RTX 3080+
Storage	100 GB SSD	500 GB NVMe
Network	100 Mbps	1 Gbps

Registry Server

Resource	Minimum	Recommended
CPU	2 cores	4 cores
RAM	4 GB	8 GB
Storage	50 GB SSD	100 GB SSD
Network	100 Mbps	1 Gbps

---

Next Steps

Choose your deployment method:

• Docker Compose - Start here for testing

• Manual - For custom setups

• Kubernetes - For production scale