2.4 Installing Device Service on Linux

IMPORTANT:To use Device Service for FIDO U2F tokens, you must allow the FIDO U2F usage on Linux. For more information, see yubico FAQ.

First, obtain the Device Service installer for your Linux distribution from Software Licenses and Downloads Portal.

For more information about how to download the installer, see Obtaining the Device Service Installer.

You can install Device Service on Linux, based on your Linux distribution:

2.4.1 Installing Device Service on Ubuntu and Debian (deb package)

Before installing the Device Service on Ubuntu and Debian, ensure to install the following necessary components:

NOTE:Before installing Device Service on Debian 10, switch to root account. Run the following command to switch to root account:

su -l

Set the root path and edit /root/.bashrc with the root privileges to add the following line:

export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

Run all commands to install all components and Device Service on Debian 10 without the prefix sudo.

  • For enabling the use of Device Service from browsers and for succeeding pre-install checks, it is required to install the NSS tools. Run the following command to install libnss3-tools component:

    sudo apt-get install libnss3-tools

  • For Card, PKI, FIDO2, and FIDO U2F methods:

    • Run the following command to install pcscd component:

      sudo yum install pcscd

    • Run the following command to install libpsclite1:

      sudo yum install libpcsclite1

  • For Bluetooth plug-in: Run the following command to install bluez component:

    sudo apt-get install bluez

Run the following command to install the Device Service on Ubuntu and Debian:

sudo dpkg -i naaf-deviceservice-debian-linux64-release-<version>.deb

2.4.2 Installing Device Service on openSUSE and SUSE

Before installing the Device Service on openSUSE and SUSE, ensure to install the following necessary components:

  • For enabling the use of Device Service from browsers and for succeeding pre-install checks, it is required to install the NSS tools. Run the following command to install libpcsclite1 and nss-tools component:

    sudo zypper install mozilla-nss-tools

  • For Card, PKI, FIDO2, and FIDO U2F methods:

    • Run the following command to install pcscd component:

      sudo zypper install pcscd

    • Run the following command to install libpsclite1:

      sudo zypper install libpcsclite1

  • For RF IDeas card reader: Install the libudev.so.0 library manually. Run the following command to link the libudev.so.1 to libudev.so.0:

    sudo ln -s <location_of_libudev1>libudev.so.1 <location_of_libudev1>libudev.so.0

  • For Bluetoothplug-in: Run the following command to install bluez component:

    sudo zypper install bluez

Run the following command to install the Device Service on openSUSE and SUSE:

sudo rpm -i naaf-deviceservice-opensuse-linux64-release-<version>.rpm

NOTE:While installing the Device Service on SUSE operating system, there may be dependency issues related to the pcsc-lite package. Therefore, you must install the required package with zypper install pcsc-lite and initiate the Device Service installation again.

2.4.3 Installing Device Service on Fedora, CentOS, RHEL

Before installing the Device Service on Fedora, CentOS, and RHEL, ensure to install the following necessary components:

  • For enabling the use of Device Service from browsers and for succeeding pre-install checks, it is required to install the NSS tools. Run the following command to install nss-tools component:

    sudo yum install nss-tools

  • For Card, PKI, FIDO2, and FIDO U2F methods:

    • Run the following command to install pcscd component:

      sudo yum install pcscd

    • Run the following command to install libpsclite1:

      sudo yum install libpcsclite1

  • For RF IDeas card reader: Install the libudev.so.0 library manually. Run the following command to link the libudev.so.1 to libudev.so.0:

    sudo ln -s <location_of_libudev1>libudev.so.1 <location_of_libudev1>libudev.so.0

  • For Bluetoothplug-in: Run the following command to install bluez component:

    sudo yum install bluez

Run the following command to install the Device Service on Fedora, CentoOS, and RHEL:

sudo rpm -Uvh naaf-deviceservice-centos-linux64-release-<version>.rpm

Run the following command to install the Device Service on Fedora, CentoOS, and RHEL without any dependencies:

sudo rpm -i --nodeps naaf-deviceservice-centos-linux64-release<version>.rpm