Please read the important instructions inside this page!
- You need very basic knowledge about Ubuntu.
- During the installation of Ubuntu, if possible, please choose ENGLISH as main language so that it will be easier for us to provide you support if needed.
- When the Dragonfly App is installed on Ubuntu inside WSL it is NOT possible to directly access the USB cameras connected to the Windows machine using the camera index provided by Windows. Anyway your USB cameras can be accessed following the instructions inside this page.
Why Dragonfly inside WSL
The Windows Subsystem for Linux, commonly known as WSL, is an optional feature available on Windows 10 that allows Linux programs to natively run on Windows (inside a Windows 10 version of the Bash shell). WSL was designed by Microsoft in partnership with Canonical, the creators of Ubuntu. Together, they have created a kernel compatibility layer based on Ubuntu. To run WSL you need:
Windows 10 64-bit version 1607 or above
CLICK HERE TO CHECK YOUR WINDOWS VERSION
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, consider that with WSL the performances are still about 20% slower than with a native Ubuntu installation.
Installation steps
Enable WSL in Windows 10
- Open PowerShell as Administrator and run:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
- Restart your computer when prompted (mandatory).
Install Ubuntu inside WSL
Click the following link to automatically install the current Ubuntu LTS release from the Microsoft store:
Install Dragonfly inside Ubuntu 20.04 or 18.04.6
- Open the Ubuntu Terminal via one of the following methods:
- search 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
- or launching the command: ubuntu2004
- Launch these commands inside the terminal:
sudo apt install unzip
- Now it is important to close the Ubuntu Terminal and re-open it again.
- Download the Ubuntu 20.04 LTS archive or the Ubuntu 18.04.6 archive with one of these 2 commands:
wget https://dragonflyupdate.s3.eu-central-1.amazonaws.com/dragonfly-deployment-2.4/dragonfly-installation-linux-2.4.0.21-Ubuntu20.zip
wget https://dragonflyupdate.s3.eu-central-1.amazonaws.com/dragonfly-deployment-2.4/dragonfly-installation-linux-2.4.0.21-Ubuntu18.zip - Extract the Ubuntu 20.04 LTS archive or the Ubuntu 18.04.6 archive with one of these 2 commands:
unzip dragonfly-installation-linux-2.4.0.21-Ubuntu20.zip
unzip dragonfly-installation-linux-2.4.0.21-Ubuntu18.zip - The launch these commands:
cd dragonfly-linux
chmod +x install.sh
./install.sh
⚠ Do you have problems with the automatic installation?
A manual installation might be required to avoid conflicts with an already existing installation of some of the Dragonfly App dependencies. You can find the manual installation steps at this link.