Installation Guide & Release Binaries

RUSEON Core is distributed as official Docker container images and precompiled, self-contained native binaries for Linux (amd64/arm64), Windows, and macOS.

---

1. Installation via Docker (Recommended)

Docker provides the fastest isolated deployment:

# Pull official image
docker pull ghcr.io/rusegal/ruseon-core:latest

# Run container with persistent volumes
docker run -d \
  --name ruseon \
  --restart unless-stopped \
  -p 8080:8080 \
  -p 8554:8554 \
  -p 50000-50100:50000-50100/udp \
  -v /var/lib/ruseon/data:/app/data \
  -v /var/lib/ruseon/recordings:/app/recordings \
  ghcr.io/rusegal/ruseon-core:latest

---

2. Precompiled Standalone Binaries

Download precompiled standalone binaries from GitHub Releases:

Linux (AMD64 & ARM64)

# Download binary (example for Linux AMD64)
curl -L -o ruseon https://github.com/rusegal/ruseon-core/releases/latest/download/ruseon_linux_amd64.tar.gz
tar -xzf ruseon_linux_amd64.tar.gz

# Move to system path and make executable
sudo mv ruseon /usr/local/bin/ruseon
sudo chmod +x /usr/local/bin/ruseon

# Verify installation
ruseon -version

Windows (AMD64)

1. Download ruseon_windows_amd64.zip from Releases.
2. Extract to C:\Program Files\RUSEON\.
3. Launch ruseon.exe or install as a Windows service via NSSM.

---

3. Building from Source

To compile the latest bleeding-edge build from source:

Prerequisites:

• Go: 1.26+ installed
• Node.js: 22+ & npm (for building the embedded React 19 UI)

Build Commands:

# Clone the repository
git clone https://github.com/rusegal/ruseon-core.git
cd ruseon-core

# 1. Build the embedded React 19 web frontend
cd web
npm install
npm run build
cd ..

# 2. Compile the Go backend with embedded UI assets
go build -ldflags="-s -w -X main.Version=$(git describe --tags --always)" -o bin/ruseon ./cmd/ruseon

# 3. Compile the CLI utility
go build -ldflags="-s -w" -o bin/ruseon-cli ./cmd/ruseon-cli

---

Verifying the Installation

# Check version
./bin/ruseon -version

# Start server with default configuration
./bin/ruseon -config config.example.yaml

Verify that the health probe responds:

curl http://localhost:8080/livez
# Output: {"status":"healthy"}

Related Documentation

• Quick Start Guide
• System Requirements
• Docker Compose Deployment
• Linux Systemd Service Setup