Run a Relay Node
Help the Gratonite network by running a relay. Lightweight, requires minimal resources.
What is a Relay?
A relay routes encrypted messages between Gratonite instances that can't reach each other directly (e.g., servers behind NAT). The relay never reads message content — it only sees encrypted envelopes and forwards them.
Quick Start
cd apps/relay
cp .env.example .env
docker compose up -d
That's it. Your relay is running.
Requirements
1 vCPU
CPU
Minimal compute
256 MB
RAM
Redis + relay
10 Mbps
Bandwidth
Scales with usage
Reputation System
Every relay has a public reputation score (0-100).
UptimeKeep your relay online
30%Delivery RateSuccessfully forward envelopes
30%LatencyLower latency = higher score
20%AgeTrust builds over time
10%ReportsAvoid abuse reports
10%Monitoring
Built-in health and Prometheus metrics endpoints:
# Health check
curl https://your-relay.com/health
# Prometheus metrics
curl https://your-relay.com/metrics
# Relay identity
curl https://your-relay.com/.well-known/gratonite-relay