Installing USB Redirector for Linux

USB Redirector for Linux box shot

USB Redirector for Linux works on the following Linux distributions:

  • Debian 5 and newer
  • Fedora 5 and newer
  • Gentoo 10.1 and newer
  • openSUSE 10.3 and newer
  • Mandriva 2007 and newer
  • RedHat 5 and newer
  • Ubuntu 6.06 and newer
  • Raspbian
  • others, which meet the following requirements:

    • kernel version from 2.6.27 to 6.19
    • udev subsystem
    • read-write file system (not read only)
    • availability of kernel source code or kernel headers package (required for installation)

Supported architectures:

  • x86
  • x86_64(amd64)
  • arm
  • mips

Installing

Before installing USB Redirector for Linux, you need to download and extract the installation package which corresponds to your system and CPU. Download links for all supported systems are available in the Downloads section.

wget https://www.incentivespro.com/usb-redirector-linux-x86_64.tar.gz
tar -zxf ./usb-redirector-linux-x86_64.tar.gz
cd ./usb-redirector-linux-x86_64


To install USB Redirector for Linux in USB server mode, use the following command:

sudo ./installer.sh install-server


To install USB Redirector for Linux in USB client mode, use the following command:

sudo ./installer.sh install-client


To install USB Redirector for Linux in combined USB server and USB client mode, use the following command:

sudo ./installer.sh install

Uninstalling

To uninstall USB Redirector for Linux, please run uninstall.sh script. It is located in the directory where USB Redirector was installed. By default, it is located in /usr/local/usb-redirector directory.

sudo /usr/local/usb-redirector/uninstall.sh uninstall

Uninstaller script will remove all installed components of USB Redirector from your computer.

Installation Troubleshooting

If you've got an error saying Kernel sources or kernel headers directory not found during installation of USB Redirector for Linux, you may need to install kernel headers or kernel source code. It is a package that contains files required to compile USB Redirector kernel module.

The command to install this package will differ, depending on your Linux distro:

Ubuntu, Debian

sudo apt-get install make gcc linux-headers-`uname -r`

Raspbian (Raspberry Pi)

sudo apt-get install make gcc linux-headers-`uname -r`

RedHat, Fedora, CentOS, Scientific

yum install make gcc chkconfig kernel-devel-`uname -r`

SuSE

sudo zypper in make gcc kernel-devel

Arch Linux, Manjaro Linux

sudo pacman -Syu make gcc linux-headers

Proxmox VE

apt-get install build-essential pve-headers-`uname -r`

Other systems

Please install kernel headers (the package may be named as "kernel-headers", "kernel-devel", "linux-headers", etc.) or kernel source code package for your system. You need to install the version that exactly corresponds to your kernel version. In addition, you will need to install make and gcc, required to build USB Redirector kernel module.

Unless DKMS is installed in your system, you may need to re-install the program each time after updating to newer Linux kernel to re-compile USB Redirector kernel module!

Kernel modules in Linux are tied to a particular kernel version, thus they need to be re-compiled for each kernel version to work correctly.

Automatic Startup of USB Redirector at Boot

The installer will normally set USB Redirector daemon for auto-start. If it was not able to do this, please use rc.usbsrvd script that is installed in /etc/rc.d (or /etc/init.d) directory to start USB Redirector automatically.