Skip to content

README.md

Latest commit

 

History

History
48 lines (33 loc) · 1.9 KB

README.md

File metadata and controls

48 lines (33 loc) · 1.9 KB

The VirtualHere client docker image allows you to use USB devices inside a container.

DockerFile here: https://github.com/virtualhere/docker/blob/master/Dockerfile

Instructions for using this image:

(This works under Windows and Mac, for Linux use KVM containers https://github.com/gotoz/runq/)

  1. Plug the USB device into a purchased virtualhere server.
  2. Run the container like this docker run -td --privileged --name vhclient virtualhere/virtualhere-client:latest ./vhclientx86_64
  3. Now you can use the virtualhere API to connect to the virtualhere server and use a device.

For example:

C:\Users\michael\docker-virtualhere-client>docker exec vhclient ./vhclientx86_64 -t "MANUAL HUB ADD,192.168.0.16"
OK

C:\Users\michael\docker-virtualhere-client>docker exec vhclient ./vhclientx86_64 -t "LIST"
VirtualHere Client IPC, below are the available devices:
(Value in brackets = address, * = Auto-Use)

Desktop Hub (SERVER:7575)
   --> Portable SSD T5 (SERVER.82)
   --> Token JC (SERVER.73) (In-use by: (michael) at 192.168.0.21)
   --> AURA Custom Human interface (SERVER.111)
   --> Corsair Link TM USB Dongle (SERVER.19)

Auto-Find currently on
Auto-Use All currently off
Reverse Lookup currently off
Reverse SSL Lookup currently off
VirtualHere Client not running as a service

C:\Users\michael\docker-virtualhere-client>docker exec vhclient ./vhclientx86_64 -t "USE,server.111"
OK

C:\Users\michael\docker-virtualhere-client>docker exec vhclient lsusb
Bus 001 Device 001: ID 1d6b:0002
Bus 001 Device 002: ID 0b05:1867

Notes:

  • The output of the lsusb command confirms the device is attached. (0b05:1867 is the device we used by issuing the USE,server.111 command)
  • You would need the normal USB device drivers in your docker container. Eg. usb-storage if you want to use a USB disk, usb-serial if you want to use a serial adapter etc , just like a normal linux setup