HydraNeck

Getting Started Overview

Site Types

HYDRA venues fall into two categories based on who manages the local network infrastructure. Both types use the same streaming software and connect to the same district server.

Partner Managed Locations

A managed network partner (telco, ISP, or managed services provider) manages the full site network: provider edge router, VLANs, switching, and the WireGuard tunnel to the district server.

Characteristics

HydraGuard Configuration

Partner-managed venues are registered in HydraGuard with a partner guard type:

hydraguard venue add museum-x --location brussels --guard partner

The partner guard type generates a minimal WireGuard peer config (public key, endpoint, allowed IPs) without PostUp/PostDown scripts, since the provider edge router is managed by the partner, not by HYDRA.

VLAN Layout (typical)

VLAN Purpose CIDR Example
Management Site infrastructure, switches 10.10X.0.0/20 10.101.0.0/20
Body Render nodes 10.10X.0.0/24 subset 10.101.1.0/24
Head / Wireless Display devices, kiosks 10.10X.4.0/20 10.101.4.0/20

What HYDRA Provides

  1. WireGuard peer profile for the site tunnel
  2. Per-site CIDR allocation
  3. Body WireGuard configs (Bodies manage their own tunnels independently)
  4. Streaming software (Sunshine on Bodies, HydraHead on Heads)

HYDRA Managed Locations

HYDRA does full network management at these locations. No managed network partner involved.

Characteristics

Router Types

Guard Type Router Use Case
omada TP-Link Omada controller Fixed venues with Omada hardware
linuxvm Linux VM gateway Cloud gateways (Azure, GCP, AWS)
neckair MikroTik router Mobile venue-in-a-box (NeckAir units)
gateway FortiGate/on-prem Enterprise venues with existing FortiGate

HydraGuard Configuration

# Fixed venue with Omada controller
hydraguard venue add exhibition-y --location antwerp --guard omada

# Mobile unit with MikroTik
hydraguard neckair add 050

# Standalone Body (no site gateway)
hydraguard air add 001

MikroTik (NeckAir) Details

For mobile deployments, HYDRA uses MikroTik routers:

Standalone Bodies (Air)

Bodies can also connect to the district server without any site gateway:

Comparison

Feature Partner Managed HYDRA Managed Standalone Body
Network management Partner HYDRA N/A (direct)
WireGuard site tunnel Partner configures HYDRA configures Body-direct
Body WireGuard tunnel HYDRA (independent) HYDRA (independent) HYDRA (same tunnel)
Local Head-to-Body Partner firewall HYDRA router Not applicable
Router hardware Partner provider edge Omada/MikroTik/Linux None
HydraGuard type venue (partner) venue (omada/linuxvm) or neckair air