ENZONICRELAY

Download

Install the Enzonic Relay agent

The agent runs next to your server as a background service. It connects out to the relay, so you never open a port on your router.

Linux (systemd)

  1. Open a terminal on the machine that runs your server.
  2. Run:
    curl -fsSL https://relay.enzonic.com/install.sh | sh
  3. The installer asks for sudo, installs the agent and registers a systemd service. It also works on a Raspberry Pi (arm64).
  4. Open the claim link it prints, sign in and press Approve.
Installer options

Set these environment variables before running the installer:

  • ENZ_RELAY_PREFIX: install directory
  • ENZ_RELAY_NO_SERVICE=1: do not register a service (run the agent yourself)
  • ENZ_RELAY_BASE_URL: download base URL
  • ENZ_RELAY_API: control plane URL

Manual downloads

Single static binaries. Check them against SHA256SUMS before running.

PlatformFile
Windows x64enzonic-relay-agent-windows-amd64.exe
macOS Apple siliconenzonic-relay-agent-darwin-arm64
macOS Intelenzonic-relay-agent-darwin-amd64
Linux x64enzonic-relay-agent-linux-amd64
Linux ARM64 (Raspberry Pi 4/5)enzonic-relay-agent-linux-arm64

Verify on Linux or macOS: sha256sum -c SHA256SUMS --ignore-missing (macOS: shasum -a 256 -c SHA256SUMS --ignore-missing). On Windows: Get-FileHash .\enzonic-relay-agent-windows-amd64.exe and compare.

Manage the agent

Service statusenzonic-relay-agent service status
Stopenzonic-relay-agent service stop
Startenzonic-relay-agent service start
Uninstall the serviceenzonic-relay-agent service uninstall
Claim again (new account or lost key)enzonic-relay-agent claim
Add a Java tunnel from the command lineenzonic-relay-agent tunnel add --proto java --port 25565

On Linux and macOS, service commands need sudo; on Windows, an Administrator terminal. See the agent docs for every command.