Troubleshooting USB Forwarding

This page covers common issues with USB device forwarding. If you encounter a problem not listed here, please check the general troubleshooting section or contact support.

Linux Linux — USB Device Not Appearing in the USB Menu

Symptom: On a Linux remote computer, the expected USB device doesn’t appear in the USB menu, or forwarding fails silently.

Root Cause: reemod failed to install the virtual USB driver, usually because the uinput kernel module isn’t enabled on the remote machine.

Solution:

  1. Check the Reemo Agent version:

    • Check the Update page and rerun the install script for your distribution to make sure you have the latest version

  2. Check that the uinput kernel module is loaded:

    • Run lsmod | grep uinput on the remote computer

    • If no line is printed, the module isn’t loaded

  3. Load the module and make it persistent:

    • Load it manually with sudo modprobe uinput

    • Make sure it’s loaded at boot (for example via /etc/modules-load.d/)

Once the uinput module is active, restart reemod and try the USB forwarding again.

Windows Windows — USB Device Not Appearing in the USB Menu

Symptom: On a Windows remote computer, the expected USB device doesn’t appear in the USB menu, or an error is shown when opening the menu.

Root Cause: The Reemo virtual USB driver, normally installed automatically with the Agent, isn’t correctly installed on the remote machine.

Solution:

  1. Check the driver status:

  2. Reinstall the Reemo Agent if needed:

    • Reinstalling the Agent also reinstalls the virtual USB driver

macOS macOS — USB Device Not Appearing in the USB Menu

Symptom: On a macOS remote computer, the expected USB device doesn’t appear in the USB menu.

Root Cause: USB forwarding on macOS requires a recent version of the Reemo Agent.

Solution:

  1. Check the Agent version:

  2. Reinstall the Reemo Agent if the version is outdated:

    • Check the Installation page and reinstall the Agent to get the latest version available

Once the Agent is up to date, restart your Reemo session and try the USB forwarding again.