🐺 Wolf — Server Clustering Tools Made Simple

<div align="center">

Free tools for building robust, clustered server infrastructure

wolfscale.org • wolf.uk.com • Discord • Reddit

© Wolf Software Systems Ltd

</div>

---

Wolf started as a database replication tool and has grown into a suite of server clustering utilities. Every tool runs as a single Rust binary, uses auto-discovery, and is designed to be simple to set up.

| Tool | Description | Status | |------|-------------|--------| | WolfStack | Server, VM & container management dashboard with Proxmox integration | ✅ Available | | WolfScale | MariaDB/MySQL replication, clustering & load balancing | ✅ Available | | WolfDisk | Disk sharing & replication across networks | ✅ Available | | WolfNet | Secure private networking across the internet | ✅ Available |

---

WolfScale — Database Replication

Database replication, clustering, and load balancing — the easy way

WolfScale is a lightweight, high-availability replication layer for MariaDB/MySQL. It provides automatic leader election with deterministic failover, WAL-based replication for strong consistency, and a MySQL-compatible proxy for transparent routing—all in a single Rust binary.

Works with MySQL, Percona, and Amazon RDS • MariaDB recommended

Why WolfScale?

| Feature | Benefit | |---------|---------| | Sub-Millisecond Replication | Push-based replication faster than MySQL, MariaDB, or Galera | | Zero Write Conflicts | Single-leader model eliminates certification failures | | Predictable Failover | Lowest node ID always wins—you know exactly who becomes leader | | Safe Node Rejoin | Returning nodes sync via WAL before taking leadership | | Zero-Config Discovery | Nodes find each other automatically via UDP broadcast | | Transparent Proxy | Connect via MySQL protocol—no application changes needed | | Built-in Load Balancer | Distribute connections across cluster nodes with automatic failover | | Single Binary | No patched databases, no complex dependencies |

Fastest Replication in the Industry

| System | Typical Replication Lag | |--------|------------------------| | MySQL Async | 100ms - seconds | | MySQL Semi-Sync | 10-50ms | | MariaDB Galera | 10-20ms | | WolfScale | <1ms ⚡ |

Quick Start

All cluster nodes MUST have identical data before starting WolfScale. WolfScale replicates new changes only — it does NOT sync existing data between nodes.

# Install WolfScale on each server
curl -sSL https://raw.githubusercontent.com/wolfsoftwaresystemsltd/WolfScale/main/setup.sh | bash

Load Balancer

Install the load balancer directly on any server that needs database access. It auto-discovers your cluster — no configuration needed.

curl -sSL https://raw.githubusercontent.com/wolfsoftwaresystemsltd/WolfScale/main/setup_lb.sh | bash

Web Server 1 ─── WolfScale LB ───┐
             (auto-discovers)    │
                                 │
Web Server 2 ─── WolfScale LB ───┼──► WolfScale DB Cluster
             (auto-discovers)    │
                                 │
Web Server 3 ─── WolfScale LB ───┘
             (auto-discovers)

Cluster Commands

wolfctl list servers     # Check cluster status
wolfctl stats            # Live throughput monitoring
wolfctl migrate --from 10.0.10.111:8080   # Migrate data to new node
wolfctl reset --force    # Reset WAL and state (DESTRUCTIVE)

---

WolfDisk — Distributed Filesystem

Disk sharing and replication across networks — the easy way

WolfDisk is a FUSE-based distributed filesystem that shares and replicates files across Linux servers. Mount a shared directory on any number of machines and have your data automatically synchronised. Supports leader, follower, and client modes.

Why WolfDisk?

| Feature | Benefit | |---------|---------| | FUSE-Based | Mount as a regular filesystem—works with any application | | Automatic Replication | Files sync to all nodes automatically | | Content-Addressed Storage | Efficient deduplication via SHA256 chunking | | Leader-Follower Model | Strong consistency with automatic failover | | Client Mode | Workstations can access the shared drive without local storage | | Multiple Drives | Run multiple independent filesystems per node |

Quick Start

# Interactive installer - prompts for node ID, role, and discovery
curl -sSL https://raw.githubusercontent.com/wolfsoftwaresystemsltd/WolfScale/main/wolfdisk/setup.sh | bash

Node Roles

| Role | Storage | Description | |------|---------|-------------| | Leader | ✅ Local | Primary node — accepts writes, replicates to followers | | Follower | ✅ Local | Receives replicated data, can become leader on failover | | Client | ❌ None | Mount-only — reads/writes forwarded to leader, no local data | | Auto | ✅ Local | Auto-election — lowest ID becomes leader |

See wolfdisk/README.md for full documentation.

---

WolfNet — Private Networking

WolfNet creates a secure, encrypted private network between your machines over the internet. Machines on WolfNet can see each other as if they were on the same LAN, but all traffic is encrypted with modern cryptography (X25519 + ChaCha20-Poly1305 — the same crypto as WireGuard).

Why WolfNet?

| Feature | Benefit | |---------|---------| | WireGuard-Class Crypto | X25519 key exchange + ChaCha20-Poly1305 AEAD encryption | | Mesh Networking | Every node can reach every other node directly — no single point of failure | | Invite/Join System | Connect new peers with a single token — no manual key exchange | | Relay Forwarding | Nodes behind NAT can communicate through a relay — no port forwarding needed | | Gateway Mode | Route internet traffic through a gateway node with NAT masquerading | | LAN Auto-Discovery | Nodes find each other automatically on the same network | | TUN-Based | Uses kernel TUN interfaces for near-native performance | | Hostname/DynDNS | Use hostnames in endpoints — re-resolved every 60s for dynamic IPs | | Single Binary | No dependencies — just wolfnet and wolfnetctl | | Systemd Service | Runs as a background service with automatic startup |

Quick Start

# Interactive installer — downloads binary, generates keys, creates systemd service
curl -sSL https://raw.githubusercontent.com/wolfsoftwaresystemsltd/WolfScale/main/wolfnet/setup.sh | sudo bash

The installer will:

• Check for /dev/net/tun (with Proxmox/LXC guidance if missing)
• Download and install wolfnet and wolfnetctl
• Generate an X25519 keypair
• Prompt for WolfNet IP address, port, and gateway mode
• Create a systemd service for automatic startup

Easy Peer Setup (Invite/Join)

Connect two machines in seconds — no manual key exchange:

# On the first machine (the one with a public IP / port forwarding):
sudo wolfnet invite

# Output:  sudo wolfnet --config /etc/wolfnet/config.toml join eyJwa...

# Copy that command and run it on the second machine:
sudo wolfnet --config /etc/wolfnet/config.toml join eyJwa...

# It will output a reverse token — run that on the first machine:
sudo wolfnet --config /etc/wolfnet/config.toml join eyJlc...

# Restart WolfNet on both:
sudo systemctl restart wolfnet

The invite token auto-detects the node's public IP, includes the public key, and assigns WolfNet IPs automatically.

NAT Traversal (Relay Forwarding)

WolfNet supports relay forwarding so machines behind NAT firewalls can communicate without port forwarding:

Laptop (behind NAT)          Server (public IP)           Home PC (behind NAT)
    10.0.10.1                   10.0.10.2                   10.0.10.3
        │                           │                           │
        └───── encrypted UDP ──────►│◄────── encrypted UDP ─────┘
                                    │
                             Relay forwards
                            packets between
                           Laptop ◄──► Home PC

How it works:

1. Both the laptop and home PC connect to the server (which has a public IP)
2. When the laptop sends a packet to the home PC, the server detects it's not the destination
3. The server decrypts, re-encrypts for the home PC, and forwards it
4. This happens automatically — no configuration needed
5. Any node that can be reached by both parties can act as a relay

Peer Discovery Methods

WolfNet supports three ways to find and connect to peers — mix and match as needed:

| Method | Use Case | Config | |--------|----------|--------| | LAN Auto-Discovery | Machines on the same network | discovery = true (default) | | Static IP | VPS, dedicated servers, data centres | endpoint = "203.0.113.5:9600" | | Hostname / DynDNS | Home broadband, dynamic IPs | endpoint = "myhome.dyndns.org:9600" |

Hostnames are resolved on startup and re-resolved every 60 seconds, so DynDNS changes are picked up automatically. Works with any DNS provider — DynDNS, No-IP, Cloudflare, DuckDNS, or your own domain.

Multi-Server Deployment (Static IPs)

Link multiple standalone servers across different locations into a single WolfNet mesh:

Server A (London)              Server B (New York)           Server C (Tokyo)
  Public: 203.0.113.5            Public: 198.51.100.10         Public: 192.0.2.50
  WolfNet