Install DL Workbench from Docker Hub*

You can run the DL Workbench by building a Docker* image locally, which is possible on both Linux* and Windows* operating systems.

NOTE: This installation option requires registration on Docker Hub.

Install DL Workbench from Docker Hub* on Linux* OS

Install Docker* CE

To install Docker CE for Linux, follow the steps described in the manual.

Set Proxy (Optional)

If you are behind a corporate proxy, you can set it by running the following commands:

1. Create a directory with a configurations file:

   mkdir -p /etc/systemd/system/docker.service.d
   touch /etc/systemd/system/docker.service.d/opts.conf

2. Save data about proxy and DNS settings on your machine to the configurations file by running the command below:

   NOTE: Replace the placeholders in the angle brackets with your proxy values.

   [Service]
   ExecStart=
   Environment="HTTP_PROXY=<http-proxy>" "HTTPS_PROXY=<https-proxy>" "NO_PROXY=<no-proxy>"

3. Let the system reread configuration and restart the Docker* container:

   systemctl daemon-reload
   systemctl restart docker

For details on customizing Docker settings, see Control Docker with systemd or contact your system administrator.

Run Docker Container

Run the Docker container with the DL Workbench:

docker run -p 127.0.0.1:5665:5665 \
                --name workbench \
                --device /dev/dri \
                -v /dev/bus/usb:/dev/bus/usb \
                --device-cgroup-rule='c 189:* rmw' \
                -e PROXY_HOST_ADDRESS=0.0.0.0 \
                -e PORT=5665 \
                -e no_proxy=<no-proxy> \
                -e http_proxy=<http-proxy> \
                -e https_proxy=<https-proxy> \
                -it openvino/workbench:latest

This command runs the Docker container named workbench with the following arguments:

Argument	Explanation
-p 127.0.0.1:5665:5665	Maps Docker container port 5665 to host port 5665 to get access to the DL Workbench from a web browser.
-v /dev/bus/usb:/dev/bus/usb	Mounts directory /dev/bus/usb to the Docker container. Enables the container to use Neural Compute Stick 2 devices in the DL Workbench.
--device /dev/dri	Add a host device to the container. Enables the container to use GPU devices in the DL Workbench.
--device-cgroup-rule='c 189:* rmw'	Add the rule with allowed devices list to the cgroup. Enables the container to use Neural Compute Stick 2 devices in the DL Workbench.
-e https_proxy=<https-proxy> -e http_proxy=<http-proxy> -e no_proxy=<no-proxy>	Optional. If you are behind a corporate proxy, set environment variables.
-it	Enables interactive processes in the DL Workbench terminal. Set to the Docker image name workbench.

When the command is executed, point your browser to http://127.0.0.1:5665. The DL Workbench Get Started page appears:

You have successfully installed the OpenVINO™ DL Workbench. Move on to Work with Models and Sample Datasets.

Install DL Workbench from Docker Hub* on Windows* OS

Install Docker Desktop*

To install Docker Desktop for Windows OS, follow the steps described in the Install Docker Desktop on Windows. When the installation is complete, start the program.

NOTE: To install Docker Desktop, you need to have an account on Docker Hub.

Set Proxy (Optional)

If you are behind a corporate proxy, you can set it in the Docker Desktop settings and in Windows PowerShell*.

To set proxy in the settings, right click on Docker Desktop in the taskbar items, select Configure proxy, and follow the scheme below:

Settings >> Proxies >> Select Manual proxy configuration >> Add your http-proxy to both Web Server and Secure Web Server >> Apply settings

Settings >> Proxies >> Add your no-proxy to Bypass for these hosts ... >> Apply settings

Now set proxy in Windows PowerShell by passing the following arguments:

$http_proxy="<your_http_proxy>"

$https_proxy="<your_https_proxy>"

NOTE: Double quotes are required for these arguments.

Run Docker Container

NOTE: For this step, Docker Desktop must be running.

Run the following command in Windows PowerShell*:

docker pull openvino/workbench:latest  

Then, run the following:

docker run -p 127.0.0.1:5665:5665 `
                --name workbench `
                -e PROXY_HOST_ADDRESS=0.0.0.0 `
                -e PORT=5665 `
                -it openvino/workbench:latest

This command runs the Docker container named workbench with the following arguments:

Argument	Explanation
-p 127.0.0.1:5665:5665	Maps Docker container port 5665 to host port 5665 to get access to the DL Workbench from a web browser.
-e https_proxy=<https-proxy> -e http_proxy=<http-proxy> -e no_proxy=<no-proxy>	Optional. If you are behind a corporate proxy, set environment variables.
-it	Enables interactive processes in the DL Workbench terminal. Set to the Docker image name workbench.

When the command is executed, point your browser to http://127.0.0.1:5665. The DL Workbench Get Started page appears:

You have successfully installed the OpenVINO™ DL Workbench. Move on to Work with Models and Sample Datasets.