Skip to content

Installation

Andrew Mello edited this page Jun 4, 2026 · 1 revision

Installation

Prerequisites

  • DASH-capable Realtek NIC (see Hardware Compatibility)
  • DASH enabled in BIOS (see BIOS Setup)
  • Realtek out-of-tree driver with DASH support: r8125, r8126, or r8127
  • wsmancli for remote management (realmanage command)

From source

# Dependencies
# Debian/Ubuntu:
sudo apt install gcc make wsmancli curl libxml2-utils

# Arch Linux:
sudo pacman -S gcc make wsmancli curl libxml2

# Build
git clone https://github.com/88plug/realtek-realmanage
cd realtek-realmanage
make

# Install to /usr/local (default)
sudo make install

# Or install to /usr
sudo make install PREFIX=/usr

AUR (Arch Linux)

# Main toolkit
yay -S realtek-realmanage

# Optional: AMD DASH CLI (adds additional capabilities)
yay -S amd-dash-cli-bin

Install targets

Target Installs
make install All binaries, library, headers, service file, pkg-config
make uninstall Removes all of the above
make check Validates bash script syntax

What gets installed

/usr/local/bin/realmanage          # Remote management CLI
/usr/local/bin/dash-activate       # Provisioning tool
/usr/local/bin/rtdashd             # OS agent daemon
/usr/local/bin/rtdash-ctl          # Low-level ioctl tool
/usr/local/lib/librtdash.a         # Static library
/usr/local/lib/librtdash.so        # Shared library
/usr/local/lib/pkgconfig/librtdash.pc
/usr/local/include/rtdash.h
/usr/local/include/rtdash_ioctl.h
/usr/lib/systemd/system/rtdashd.service

Driver requirement

The mainline r8169 kernel driver has DASH awareness but does not expose the management ioctl. You need Realtek's out-of-tree drivers:

# RTL8125BP (2.5 GbE) — primary DASH target
git clone https://github.com/openwrt/rtl8125
cd rtl8125
# Edit Makefile: ENABLE_DASH_SUPPORT = y
make && sudo make install

# RTL8126 (5 GbE)
# RTL8127AP (10 GbE)
# — available from Realtek directly

Verify the driver is loaded with DASH support:

dmesg | grep -i "r8125\|dash"

Clone this wiki locally