Shugur Relay Cluster

Deploy a high-availability distributed Nostr relay network

High Availability Distributed Cluster Auto Failover 20+ NIPs

Why Choose Shugur Distributed Architecture?

Unlike traditional single-relay setups, Shugur provides a distributed cluster that eliminates single points of failure while maintaining simplicity for developers.

Single Connection Point

Connect to one relay endpoint and access the entire distributed network. No need to manage multiple relay connections in your applications.

Developer Benefit: Simplified client code with built-in redundancy

Automatic Failover

If one relay in the cluster fails, your connection automatically routes to healthy nodes. Data remains accessible without client-side intervention.

Reliability: 99.9% uptime with transparent failover

Data Redundancy

Events are replicated across multiple nodes in real-time. Your data is safe even if individual relays go offline for maintenance.

Data Safety: Multi-node replication with consistency guarantees

Get Started in Minutes

Deploy your first Shugur relay cluster with a single command, then scale seamlessly as your network grows.

Quick Deployment

Standalone Deployment

Perfect for development, testing, or small-scale production

curl -fsSL https://github.com/Shugur-Network/relay/raw/main/scripts/install.standalone.sh | sudo bash

• Single-node deployment
• Automatic SSL certificates
• Web interface included

Distributed Deployment

Production-ready, high-availability multi-node setup

curl -fsSL https://github.com/Shugur-Network/relay/raw/main/scripts/install.distributed.sh | sudo bash

• Multi-node HA cluster
• Load balancing & failover
• CockroachDB storage

What Happens Next

• Automated setup with SSL certificates
• CockroachDB distributed storage configured
• Load balancing and failover protection active
• Single endpoint ready for client connections

Production Ready

• 20+ NIPs supported for maximum compatibility
• Enterprise-grade security and rate limiting
• Comprehensive monitoring and observability
• Go-based implementation for high performance

Traditional vs. Distributed Architecture

See how Shugur's distributed cluster simplifies development while improving reliability.

Traditional Multi-Relay Setup

Client manages multiple connections manually

Complex failover handling in application code

Data inconsistency between different relays

Increased development and maintenance complexity

Client → Relay A (manual)
Client → Relay B (manual)
Client → Relay C (manual)
// Complex client-side management

Shugur Distributed Cluster

Single connection point for all clients

Transparent automatic failover and load balancing

Real-time data synchronization across nodes

Simple client implementation and maintenance

Client → Shugur Cluster Endpoint
   ├─ Node A (active)
   ├─ Node B (standby)
   └─ Node C (standby)
// Automatic cluster management

Complete Setup Documentation

Everything you need to deploy, configure, and maintain your Shugur relay cluster.

Quick Start Guide

The fastest way to deploy Shugur Relay with automated installation scripts. Choose between standalone or distributed deployment options with comprehensive setup instructions.

View Quick Start Guide

Installation & Configuration

Complete installation guide with Docker, bare metal, and distributed options. Includes configuration management, performance tuning, and troubleshooting resources.

View Installation Guide

Key Benefits for Developers

The Shugur distributed relay architecture means you no longer need to implement complex multi-relay management in your applications. Connect to a single endpoint and get automatic high availability, load distribution, and data redundancy - all transparent to your client code while ensuring your users can always access their data.

Deploy Your HA Relay Network

Experience the simplicity of single-connection Nostr infrastructure with enterprise-grade reliability.