What is WSL

The Windows Subsystem for Linux, or WSL, is an optional feature available on Windows 10 that allows Linux programs to run natively on Windows (in a Windows 10 version of the Bash shell). WSL was designed by Microsoft in partnership with Canonical, the creators of Ubuntu. Together, they created a kernel compatibility layer based on Ubuntu. To run WSL you need Windows 10 64-bit version 1607 (the Anniversary update) or above (32-bit versions are not supported). You can check your Windows version here.

BEFORE CONTINUING: please be aware that at present WSL can’t access the integrated or USB cameras connected to the Windows machine. This means that Dragonfly will be able to access ONLY H.264 or MJPEG video stream made available by network cameras through a local or Internet connection (e.g. the CSI/USB camera connected to a Raspberry Pi or the integrated camera of a smartphone/tablet etc..).

Why Dragonfly with WSL

Using WSL is different from installing a virtual machine (with VMware or Virtual Box), as with WSL the Linux system runs natively on Windows. There is no third party involved and this means that the level of performances is much higher than when using a virtual machine. Despite this it must be said that even with WSL the performances are about 20% slower than a native Ubuntu installation.

Step 1 – Enable WSL in Windows 10

  1. Open PowerShell as Administrator and run:
  2. Restart your computer when prompted.

Step 2 – Install Ubuntu inside WSL

Click the following link to automatically install the current Ubuntu LTS release from the Microsoft store: Ubuntu 18.04 LTS (Bionic).

Step 3 – Install Dragonfly

  1. Launch the Ubuntu Terminal via one of the following methods:
    • Searching for UBUNTU inside the Windows Start menu
    • or from the Windows command line using the wsl command.
    • or from the Windows command line launching the command: ubuntu1804
  2. Install Unzip with this command:
  3. Close the Ubuntu Terminal and launch it again.
  4. Download the latest version of Dragonfly with this command:
  5. Launch these commands to install Dragonfly:

Step 4 – Launch Dragonfly

Do you have already a set of credentials? If not already done please generate a set of Accuware credentials (usernamepassword and Site ID) filling the form at this link.

  1. Go the directory where the start.sh script is located (cd dragonfly_linux/application/) and enter the following command to launch the Dragonfly Java App:
  2. Open a tab inside your favorite browser and type the following URL to launch the Dragonfly Web UI:
  3. You have now to configure Dragonfly following the instructions inside this page.

PLEASE READ: during the configuration of Dragonfly you will have to compute the calibration of your camera and you will have to make available the JSON calibration file to the Dragonfly installation running on Ubuntu inside WSL. To do so please read use these commands:

Creating/changing Linux files in your Appdata folder from Windows will likely result in data corruption and/or damage your Linux environment requiring you to uninstall & reinstall your distro!