Dockerized OSVR

A collection of Dockerfiles to dockerize OSVR, including:

• OSVR-Core
• OSVR-Tracker-Viewer
• OSVR-WebVR for running OSVR-enabled Firefox
• Open Broadcaster Software for mirroring/recording an HMD screen

Developing:

• OSVR-Unity

TODO

• OSVR-Unity palace demo
• OSVR-Unreal
• OSVR-SteamVR
• seperate osvr/server image from osvr/core
• remove --privileged from osvr_server.sh if possible, determine specifically which devices are needed
• remove nvidia/opengl from OSVR-Core if it is not needed
• extract common package deps into base image (wget)

Note

OpenGL is provided by nvidia, change the Dockerfile to match your host.

Host Setup

(optional) Install udev rules for OSVR HDK group permissions (plugdev) and device symlink (/dev/ttyUSB.OSVRHDK), restart udev to make changes live.

sudo cp 99-osvr.rules /etc/udev/rules.d/
sudo /etc/init.d/udev restart

Installation

1. edit OSVR-Core/Dockerfile

   • set _NVIDIA_VERSION to match the nvidia binary version of the host OS
   • optionally, set _USER_ID to match the userid on the host OS that you want to own created files

2. build

   docker build -t osvr/core:latest OSVR-Core

3. configure: place your osvr_server configuration files in the config/ directory

4. run

   bin/osvr_server.sh config/<your_osvr_server_config>.json

Reference

• https://github.com/OSVR/OSVR-Core/blob/master/doc/Building.md
• https://github.com/OSVR/OSVR-Docs/blob/master/Getting-Started/Installing/Linux-Build-Instructions.md
• https://bitbucket.org/monkygames/osvr-core-ubuntu-build-script/src
• https://github.com/OSVR/OSVR-Docs/blob/master/Configuring/osvrhdk.md
• https://github.com/OSVR/OSVR-JSON-Schemas/blob/master/osvr_server_config_schema.json

Other Information

• to check the firmware version of the IR camera

  lsusb -v -d 0bda:57e8 | grep bcdDevice

• video has to be sent to the HMD in order for OSVRTrackerViewer to register display

  [TrackerViewer] /me/head - got first report, enabling display!
  

• the environment variable OSVR_HOST is used to set the location of the osvr_server if not the default localhost:3883