JeVois  1.18
JeVois Smart Embedded Machine Vision Toolkit
Share this page:
Using Virtualbox to setup jevois-sdk in a virtual machine

It is highly recommended that you use a virtual machine software to create a fresh installation of Ubuntu into which you will install the JeVois development environment. This way, you will not encounter problems with differemt versions of packages required by JeVois and by possibly other applications you run on your desktop and laptop.

Here are summary instructions on how to do this with the free Virtualbox software:

  • Download and install Virtualbox from (get the version for your current computer, which is called the host computer, e.g., if using a Mac, get the version for OS X host).
  • Download and install the corresponding VirtualBox Oracle VM VirtualBox Extension Pack, making sure that the version of the extension pack matches exactly the version of Virtualbox you installed.
  • IMPORTANT: you must restart your computer for the installation to work properly later on. Especially for Mac users, it is unusual to have to reboot your mac, but you need to do it here otherwise video capture will likely not work later on.
  • Create a new virtual machine: select Linux 64-bit OS, allocate as much RAM and CPU as is reasonable (usually, move the sliders to the point where they become red), and create a new virtual hard drive, using the VDI method and selecting at least 50GB size.

    Above: creating a new virtual machine
    Above: setting memory size
    Above: Creating a virtual hard disk
    Above: Selecting VDI hard disk type
    Above: We recommend setting VDI size to at least 50GB for JeVois-A33 and 150GB for JeVois-Pro
  • Get Ubuntu 20.04 Desttop amd64 iso file from
  • Start your virtual machine. Because it has no operating system yet, you will be asked to provide an iso file, select the Ubuntu iso you just downloaded.
  • Install Ubuntu. Make sure you allocate the whole virtual disk to a single root partition (this is the default when asked how to format the disk), so that there is plenty of room in the root partition.
  • After Ubuntu is installed, you can start it, open a terminal, and proceed with the installation of the JeVois SDK as detailed in JeVois Ubuntu packages and source code repositories and in the programmer setup tutorial.
  • To be able to grab video, go to the settings of your virtual machine (yellow cog-wheel in the main panel of Virtualbox) and make sure that you enable USB 2.0 or USB 3.0 under Ports, USB. Then plug-in a USB camera, and add a device filter for it (click the icon with the + sign on top of a USB connector). We recommend that you then restart your virtual machine and your host.

    Above: adding a USB filter
    Above: you can also enable a connected USB camera using the little USB connector icon at the bottom of your virtualbox screen.
  • Back to the virtual machine, install guvcview by typing:

      sudo apt install guvcview

    and you should be able to grab video from your USB camera.

    Above: guvcview working inside virtualbox

Headless VirtualBox

When using a Linux host, it is often more convenient to just run the JeVois SDK virtual machine in a terminal, without the whole graphical interface. This allows you to simply copy/paste commands from another terminal to the one that runs your virtual machine. You cannot run jevois-inventor in that headless machine, so this is more for C++ development and compilation.

To enable headless mode, you need to enable an SSH port forwarding rule on your virtual machine, as follows:

  • in a terminal on your host machine, create a key with empty password, if you do not already have one:
      ssh-keygen -t rsa
    When prompted for a passphrase, just press ENTER.
  • on the virtual machine, install openssh-server:
      sudo apt install openssh-server
  • in VirtualBox, select Settings for your virtual machine, then Network, click on Advanced, and then Port Forwarding. Click on the little icon with a green plus sign to add a rule, as follows:

    • name: ssh
    • protocol: TCP
    • Host IP: leave blank
    • Host port: 3000 (or any unused port over 1000)
    • Guest IP: leave blank
    • Guest port: 22

    And click Ok. This will forward connections made to your host machine on port 3000 to the virtual machine port 22 (ssh).

  • Copy your key from the host to the virtual machine:
      ssh-copy-id -p 3000 jevois@localhost
    When asked, type password jevois
  • You can now shutdown your virtual machine and close VirtualBox.
  • To start the virtual machine headless and log into it:

      VBoxManage startvm UbuSdk2004 --type headless
      sleep 20
      ssh -p 3000 jevois@localhost

    Replace UbuSdk2004 above by the name you have chosen when creating your virtual machine (this is the name that appears on the sidebar with the list of machines in the VirtualBox graphical interface).

    All done, you should now be logged into your virtual machine. Remember to shut it down with sudo shutdown -h now when finished.