Getting Started
This guide covers the prerequisites for installing Shugur Relay. Ensure your system meets these requirements before proceeding with the installation.
Why Choose Shugur Relay?
Shugur Relay’s High Availability (HA) distributed cluster architecture provides unique advantages:
- Simplified Operations: Deploy once, connect everywhere - no client-side multi-relay management
- Automatic Failover: Built-in redundancy ensures 99.9%+ uptime without manual intervention
- Data Persistence: Your data lives across the cluster network, not on a single point of failure
- Enterprise Ready: Designed for production workloads with monitoring, metrics, and scalability
System Requirements
These are the minimum requirements to run Shugur Relay. For HA cluster deployments, these requirements apply per node. Production environments may require more resources based on usage.
Resource | Standalone | Distributed (per node) |
---|---|---|
CPU | 2 Cores (minimum) | 4 Cores (minimum) |
RAM | 4 GB (minimum) | 8 GB (minimum) |
Storage | 20 GB SSD (minimum) | 50 GB SSD (minimum) |
Software Prerequisites
For Docker Installations (Recommended)
- Docker: Version 20.10 or newer.
- Docker Compose: Version 2.0 or newer.
curl -fsSL https://get.docker.com -o get-docker.shsh get-docker.sh
For Bare Metal Installations
- Go: Version 1.24 or newer.
- CockroachDB: Version v24.1.x.
- Git, Curl, Wget, OpenSSL.
Network Requirements
The following ports must be accessible on your server(s).
Port | Protocol | Description | Required For |
---|---|---|---|
80/443 | TCP | HTTP/HTTPS for Caddy reverse proxy | All |
8080 | TCP | Shugur Relay WebSocket and API | All |
8181 | TCP | Prometheus metrics endpoint | All |
9090 | TCP | CockroachDB Admin UI | All |
26257 | TCP | CockroachDB SQL client connections | All |
26258 | TCP | CockroachDB inter-node communication | Distributed Only |
22 | TCP | SSH for installation script | Distributed Only |
Next Steps
Now that you have reviewed the prerequisites, you are ready to install Shugur Relay.
[→] Proceed to the Installation Guide