Skip to content

Installation

DMXRouter edited this page Mar 25, 2026 · 1 revision

Installation

Windows

  1. Download DMXRouter-Setup.exe from the Releases page
  2. Run the installer — all dependencies are included
  3. UAC will prompt for administrator privileges automatically if your account has them. This enables VLAN management without needing to right-click "Run as administrator"

VLAN management requires Windows Pro or Enterprise with Hyper-V enabled.

Linux

Download the binary for your architecture:

  • DMXRouter-vX.X.X-linux-x86_64.zip — standard PCs and servers
  • DMXRouter-vX.X.X-linux-arm64.zip — Raspberry Pi 4/5, Orange Pi, and other ARM64 boards

Install the Qt6 runtime:

# Ubuntu / Debian / Raspberry Pi OS
sudo apt install libqt6core6 libqt6gui6 libqt6widgets6 libqt6network6 libqt6websockets6 libqt6openglwidgets6

# Fedora
sudo dnf install qt6-qtbase qt6-qtwebsockets

# Arch
sudo pacman -S qt6-base qt6-websockets

Then extract and run:

unzip DMXRouter-vX.X.X-linux-x86_64.zip
chmod +x DMXRouter
./DMXRouter

VLAN management requires NetworkManager (sudo apt install network-manager if not present). The app prompts for your password when needed — no need to run as root.

macOS

Download the .app bundle from the Releases page. Qt6 frameworks are bundled inside.

Requires macOS 13.0 (Ventura) or later.

First launch: macOS quarantines apps downloaded from the internet. Double-click install.command (shipped alongside the app) to remove the quarantine and sign it locally. You only need to do this once. Alternatively, run manually in Terminal:

xattr -cr DMXRouter.app
codesign --force --deep --sign - DMXRouter.app

Important: Disable the macOS Application Layer Firewall for reliable real-time DMX operation (System Settings → Network → Firewall → OFF). The built-in firewall introduces random delays on UDP traffic. If you need firewall protection, use PF (pfctl) instead.

The app prompts for your password when needed — no need to run with sudo.

Clone this wiki locally