Install qbase+ on Linux through VirtualBox on your Windows / Mac computer

The workaround describes below provides a workaround for Windows / OSX users who are currently not able to login to qbase+.

1. Download and install VirtualBox

VirtualBox is open-source cross-platform virtualization software that allows you to run multiple guest operating systems (virtual machines) simultaneously.

You can download the latest version of VirtualBox here. Please make sure you select the version suited for your operating system (i.e. Windows user should download the package for Windows hosts").

Once the file has been downloaded you can install it on your system as you would do with any other software package.

2. Download Ubuntu

Browse to the Ubuntu website and download Ubuntu 20.04.3 LTS (please keep in mind that this version of Ubuntu only works on 64-bit machines).


3. Install Ubuntu

  • Start VirtuaBox and select New in the top taskbar.


  • Give your Virtual Machine a name, choose Linux as the Type and select Ubuntu (64-bit) as the Version before you proceed.


  • Choose how much RAM you want to assign to the virtual machine and select Next.  We recommend a minimum of 4096MB and a maximum of 50% of the available RAM.


  • Choose Create a virtual hard disk now and select Create


  • Choose VDI (VirtualBox Disk Image) and select Next.


  • Choose Dynamically allocated or Fixed size for the storage type and select Next.


  • Choose how much space you wish to set aside for Ubuntu and select Create. We recommend to choose at least 10.00 GB and a maximum of 50% of the free space on your HDD.


  • The name of your virtual machine will now appear on the left side of the VirtualBox manager. Select Start in the toolbar to launch your VM.


  • This is the point where you need to choose the Ubuntu ISO file you downloaded earlier. If the VM doesn't automatically detect it, select the folder next to the Empty field.


  • Select Add in the window that pops up.


  • Choose your Ubuntu disk image and select Open.

Select Choose.


  • Select Start.


  • Your VM will now boot into a live version of Ubuntu. Choose your language and select Install Ubuntu.
  • Choose your keyboard layout and select Continue.
  • Choose Normal installation or Minimal installation, then select Continue.
  • Choose Erase disk and install Ubuntu and select Install Now, then select Continue to ignore the warning.
  • Choose your time zone on the map, then select Continue.
  • Set up your user account and select Continue. Installation might take a few minutes.
  • Select Restart Now. Your virtual machine will now ask to "Remove the installation media, and press Enter". You do need actually need to remove anything, since there is no physical medium to remove. Simple press the Enter key on your keyboard to continue.
  • A common issue when installing setting up a virtual machine is the display resolution. To change the resolution setting in Ubuntu click the down arrow in the upper right corner and select "Settings". You can change the resolution under the displays setting. For most displays these days, 1920 x 1080 will work great.

3. Install Java 

Open the Ubuntu terminal 

$ sudo apt update
$ sudo apt install openjdk-8-jdk


You have successfully installed Java 8 on your system. Let’s verify the installed and current active version using the following command.

$ java -version

openjdk version "1.8.0_292"
OpenJDK Runtime Environment (build 1.8.0_292-8u292-b10-0ubuntu1~20.04-b10)
OpenJDK 64-Bit Server VM (build 25.292-b10, mixed mode)


Setup JAVA_HOME variable

$ sudo nano /etc/environment

At the end of this file, add the following line


Save the file and exit the editor.


Now reload this file to apply the changes to your current session:

$ source /etc/environment


Verify that the environment variable is set:

$ echo $JAVA_HOME

You’ll see the path you just set:



4. Download qbase for Linux

Sign in to your qbase+ account and download the qbase+ installer for Linux 64-bit