These instructions show how to run the DL Workbench from Docker Hub* on Linux, whether with a starting script or a docker run
command. See Install DL Workbench on Docker Hub to run the DL Workbench on other operating systems.
To run DL Workbench on Linux, install Docker CE for Linux first.
These steps show you how to use a script that starts or updates the DL Workbench on Ubuntu. If you do not want to use a script, use the alternative instructions.
To quickly start or update the DL Workbench in a Docker container, use one of these options:
Use a single command:
Manually start the script:
NOTES:
- To download the script using the command line, you must have GNU Wget installed.
- While the single command option is the simplest, it is also limiting as it uses default settings. Run the script with more parameters if you need to specify proxy settings or if you want to use hardware other than a CPU. For greater control, use the steps to manually start the script.
You can run the Docker container in either interactive mode or detached mode.
docker stop workbench
command. To monitor logs in the detached mode, run docker logs workbench
.The parameter set depends on the targets you have on your machine. Choose the combination that suits you and provide appropriate arguments in the starting script:
NOTE: To enable Intel® Vision Accelerator Design with Intel® Movidius™ VPUs in the DL Workbench, install the OpenVINO™ toolkit for Linux* first.
CPU
Choose your preferred mode and run the corresponding commands:
Interactive mode:
Detached mode:
~/.workbench
directory. To store the token in a different directory, replace ~/.workbench
with the correct directory location. See Enter DL Workbench for details.You have successfully installed the OpenVINO™ DL Workbench and are ready to work with the models and sample datasets.
CPU and Intel® Processor Graphics (GPU)
Choose your preferred mode and run the corresponding commands:
Interactive mode:
Detached mode:
~/.workbench
directory. To store the token in a different directory, replace ~/.workbench
with the correct directory location. See Enter DL Workbench for details.You have successfully installed the OpenVINO™ DL Workbench and are ready to work with the models and sample datasets.
CPU and Intel® Neural Compute Stick 2
Choose your preferred mode and run the corresponding commands:
Interactive mode:
Detached mode:
~/.workbench
directory. To store the token in a different directory, replace ~/.workbench
with the correct directory location. See Enter DL Workbench for details.You have successfully installed the OpenVINO™ DL Workbench and are ready to work with the models and sample datasets.
CPU and Intel® Vision Accelerator Design with Intel® Movidius™ VPUs
NOTE: You must have the OpenVINO toolkit installed before using these instructions. See the prerequisites. Do not remove the archive you used to install the OpenVINO™ toolkit. The DL Workbench uses this archive.
Step 1. Use the Configuration Guide for Intel® Vision Accelerator Design with Intel® Movidius™ VPUs to set up the dependencies on the host system. This is required to execute hddldaemon
, which communicates between the HDDL plugin and the board.
Step 2. In the terminal, run hddldaemon
on the host machine:
Step 3. Choose your preferred way to run the Docker container and run the corresponding commands:
Interactive mode:
Detached mode:
~/.workbench
directory. To store the token in a different directory, replace ~/.workbench
with the correct directory location. See Enter DL Workbench for details.You have successfully installed the OpenVINO™ DL Workbench and are ready to work with the models and sample datasets.
CPU, GPU, and Intel® Neural Compute Stick 2
Choose your preferred way to run the Docker container and run the corresponding commands:
Interactive mode:
Detached mode:
~/.workbench
directory. To store the token in a different directory, replace ~/.workbench
with the correct directory location. See Enter DL Workbench for details.
CPU, GPU, and Intel® Vision Accelerator Design with Intel® Movidius™ VPUs
NOTE: You must have the OpenVINO toolkit installed before using these instructions. See the prerequisites. Do not remove the archive you used to install the OpenVINO™ toolkit. The DL Workbench uses this archive.
Step 1. Use the Configuration Guide for Intel® Vision Accelerator Design with Intel® Movidius™ VPUs to set up the dependencies on the host system. This is required to execute hddldaemon
, which communicates between the HDDL plug-in and the board.
Step 2. In the terminal, run hddldaemon
on the host machine:
Step 3. Choose your preferred way to run the Docker container and run the corresponding commands:
Interactive mode:
Detached mode:
~/.workbench
directory. To store the token in a different directory, replace ~/.workbench
with the correct directory location. See Enter DL Workbench for details.You have successfully installed the OpenVINO™ DL Workbench and are ready to work with the models and sample datasets.
docker run
CommandThis section gives you an alternative to run the Docker container if you do not want to use a script.
To start a Docker container with CPU support, run the following:
IMPORTANT: If you have run the DL Workbench before, pull the latest Docker image:
docker pull openvino/workbench
For more options, like enabling other devices or changing container settings, see the Parameter Command-Line arguments.
You have completed the instructions to run the DL Workbench in a Docker container on Ubuntu.