Skip to content

Desktop Admin (GUI)

Cross-platform desktop application (ololo-relay-admin, Linux and Windows x64) for operating ololo-relay mesh clusters. Connects to the master over the same :443 TLS port as regular mesh traffic (or over an SSH loopback tunnel — see Ansible), supports English and Russian UI locales (defaulting to English, with a live switcher in the header), and ships in lockstep with the server package version.

Tabs & Capabilities

Open multiple independent clusters side by side using the + button in the top bar. Each cluster workspace provides five sections:

  • Settings — cluster tab label, master address (host:443), encrypted Admin token (stored via OS keyring safeStorage / libsecret on Linux and DPAPI on Windows), and instant Verify (WhoAmI) check.
  • Nodes — full peer inventory filtered by type (All / Servers / Clients), live Online / Offline indicator, roles, endpoints, HTTP response mode, real-time throughput in Mbps, failover priority badges (#1, #2, …), active gateway indicator per edge node, and running software version. Supports one-click registration, in-place editing (✏), and instant revocation (🗑).
  • Clients — live registry of LAN devices and VPN clients behind edge gateways: inner source IP, ingress edge, traffic counters, Anomaly/Scan alerts, and the effective LPM routing rule. Click ⚙ on any row to create or edit a per-client rule immediately.
  • Routes — unified three-panel policy editor:
    1. Standard destination routes by domain suffix and CIDR with + Route, one-click Local route (local-bypass), and CSV export;
    2. Per-client & subnet split routing (+ Client rule) — bind individual client IPs or CIDRs (optionally scoped to a specific edge) to their own gateway failover list and isolated route table (Copy from standard included);
    3. Cluster policy bar — global default mode (relay, direct, drop with ordered failover peers) and the Block torrents (BitTorrent / P2P) toggle.
  • Traffic View — real-time routing decision stream across all or selected nodes with configurable backfill, instant host/IP/rule filter, CSV export, and deduplicated Unique Hosts (SNI) / Unique IP:port tables where checked entries can be added directly into a route in one click.

Download (Windows x64)

Version: checking…

  • Installer — system installation, Start Menu shortcut, standard uninstaller.
  • Portable — single self-contained executable, no installation.
  • SHA256SUMS — SHA-256 checksums.

Self-contained build — no external runtimes required. If Windows SmartScreen prompts on first launch (“Windows protected your PC”), click More info → Run anyway (Authenticode signing is not configured yet).

Install (Linux x64)

Supported on Ubuntu 24.04+, Debian 12+, Fedora 40+, and RedOS 7.x. If the repository is already configured:

sudo apt install ololo-relay-admin      # Debian / Ubuntu
sudo dnf install ololo-relay-admin      # Fedora / RedOS

If setting up from scratch:

curl -fsSL https://repo.ololo.tech/setup.sh | sudo sh
sudo apt install ololo-relay-admin      # Debian / Ubuntu
sudo dnf install ololo-relay-admin      # Fedora / RedOS

Appears in your desktop application launcher as ololo-relay Admin and runs from the terminal as ololo-relay-admin (installed under /opt/ololo-relay-admin/).

Connection Requirements

Provide the master address (host:443) and a token belonging to a peer with admin: true (for example an operator entry with kind: client and roles.admin: true). Non-admin tokens connect in read-only mode and receive PermissionDenied on policy mutations.