Forwarding a Guardant USB key to a Docker container is the process when a physical device connected to the host machine becomes available inside a Docker container to work with.

Before you start, make sure that the Guardant key is compatible with Linux OS. GNU/Linux native support is implemented for the models:

  • Guardant Sign;
  • Guardant Time;
  • Guardant Code;
  • As well as for the network versions of the above models.

Models that aren’t supported:

  • Guardant Stealth III / Net III;
  • Guardant Stealth II USB / Net II USB.

To forward a USB key to a Docker container, do the following:

  1. Run the command to view the list of connected USB devices:
    lsusb
    Example of information output about USB devices connected to the system:
    Bus 001 Device 006: ID 0a89:0008 Aktiv Guardant Stealth 3 Sign/Time

    Memorize the Bus and Device values for the required device. In this example, they are 001 and 006.

  2. Open the guardant-docker.service file for editing:

    nano /etc/systemd/system/guardant-docker.service

  3. Add the following lines to the file:

    [Service]
Restart=always
ExecStart=/usr/bin/docker run --rm --device=/dev/bus/usb/BUS value/Device docker_IMAGE value 
ExecStop=/usr/bin/docker stop CONTAINER_ID

    you must:

    1. Replace the Bus and Device values with the actual values from the output of the lsusb command.
    2. Instead of docker_IMAGE, specify the required Docker image (see Installing and launching Axxon One using Docker).
    3. Instead of CONTAINER_ID, specify the identifier of the container.
      For example:
      [Unit]
Description=Start Docker container with Guardant USB
After=network.target docker.service
Requires=docker.service

[Service]
Restart=always
ExecStart=/usr/bin/docker run --rm --device=/dev/bus/usb/001/006 ec03cff81943
ExecStop=/usr/bin/docker stop 71cfe3eb9019

[Install]
WantedBy=multi-user.target

  4. Run the following commands to activate autostart:
    sudo systemctl daemon-reload
sudo systemctl enable guardant-docker.service
sudo systemctl start guardant-docker.service

  5. Restart the operating system.

After you restart the operating system, the container starts automatically. The Guardant USB key is available inside the container, and it will be correctly detected by the system when creating a license, for example.