HashRelay

Downloads

Pre-built binaries for the HashRelay client and server, plus the web admin UI bundle, across all supported platforms.

Legal & Compliance Notice

HashRelay is a general-purpose network infrastructure tool. You are solely responsible for ensuring that your use of cryptocurrency mining and this software complies with the laws and regulations of your country or jurisdiction. Mining and related activities are restricted or prohibited in some regions — please review and follow your local rules before downloading or deploying.

Client 0.2.3

Released 2026-08-16
Release Notes
  • •- Add transport policy (auto/quic/tcp) for control-plane connections
  • •- Split TCP and QUIC tunnel stacks with non-blocking miner accept
  • •- Keep miners connected across transient upstream disconnects
  • •- Improve control-channel backpressure under high concurrency

One-line install

Install with environment variables (recommended)

Create a client node on the server first (Web UI → Client Nodes). Replace YOUR_* values inline, then run. On OpenWrt (already root), omit sudo and pipe to env … sh.

bash
# Create a client node on the server first (Web UI → Client Nodes).
# Replace YOUR_* values below with your own before running.

curl -fsSL https://downloads.hashrelay.net/hashrelay/scripts/install-client.sh | \
  sudo env \
    SERVER_ADDR=YOUR_SERVER_IP \
    TCP_PORT=8555 \
    QUIC_PORT=9555 \
    CLIENT_ID=YOUR_CLIENT_ID \
    TOKEN=YOUR_ACCESS_TOKEN \
    sh

# OpenWrt / already root: omit sudo — pipe to "env ... sh" instead

Or install interactively

No env vars — the installer prompts for server address, ports, client ID, and token.

bash
# Interactive install — the script prompts for each value.
curl -fsSL https://downloads.hashrelay.net/hashrelay/scripts/install-client.sh | sudo sh

Or install first, configure later

Run the one-line install, edit the config file, then restart the service — Linux (systemd): sudo systemctl restart hash-relay-client; OpenWrt (procd): /etc/init.d/hash-relay-client restart.

bash
# Install first, edit config, then restart:
curl -fsSL https://downloads.hashrelay.net/hashrelay/scripts/install-client.sh | sudo sh
# OpenWrt / already root: omit sudo on the line above

# Edit /etc/hash-relay/client.toml — set server_addr, tcp_port, quic_port, client_id, token
sudo nano /etc/hash-relay/client.toml

# Restart — Linux (systemd):
sudo systemctl restart hash-relay-client

# Restart — OpenWrt (procd):
/etc/init.d/hash-relay-client restart

The config file is written to /etc/hash-relay/client.toml.

Requires root (or sudo). Supports systemd and OpenWrt/procd init systems.

Linux

Linux x86_64 (glibc)
hr-client-linux-amd64 · 16.8 MB
Download
417d63f2822bf892…
Linux x86_64 (musl)
hr-client-linux-amd64-musl · 15.7 MB
Download
00788db1efb7a0ee…
Linux ARM64 (glibc)
hr-client-linux-arm64 · 13.9 MB
Download
2dcc8bf724603a0f…
Linux ARM64 (musl)
hr-client-linux-arm64-musl · 13.0 MB
Download
3af1332b9ce100ee…
Linux ARMv7
hr-client-linux-armv7 · 12.8 MB
Download
e64413c75f61cc9c…
Linux RISC-V 64
hr-client-linux-riscv64 · 12.4 MB
Download
7a62ed2c48e5fb67…

Config Template & Quick Run

Download the annotated config template, save it as client.toml, edit the values, and pass it to the binary.

Then start the binary with the config file:

bash
# Linux / macOS
./hr-client --config client.toml

# Windows (PowerShell)
.\hr-client.exe --config client.toml

Uninstall

Run the uninstaller to stop the service, remove the binary, and optionally delete config and data.

bash
curl -fsSL https://downloads.hashrelay.net/hashrelay/scripts/uninstall-client.sh | sudo sh

Requires root (or sudo). Prompts before deleting config/data; pass --yes for non-interactive removal.