Running in a Virtual Machine

This Quick Start describes one way to run OSGeoLive within a VirtualBox virtual machine. For other methods, follow links from the “See Also” section below.

Virtual Machine Advantages

  • The response speed of a VM is much faster than on the DVD, and typically comparable with installing directly on the host machine.
  • All configuration changes, software updates, and saved files are permanent, just like on any “regular” computer. So:
  • You can customize and update the system
  • You can save your work within the VM
  • You can install additional software
  • You can backup your virtual machine installation.

System Requirements

  • RAM: 2 GB at least. The Lubuntu system runs well with 1 GB of RAM, and you’ll need to keep at least the same amount of memory for your host system. So a total of 2 GB will be needed for smooth operation. Some applications, like GeoServer, needs the virtual machine to have at least 2GB of RAM. So if possible, consider providing 2 GB or more for your virtual machine.
  • Spare Hard Disk Space: The virtual disk file (vmdk) from unzips to almost 10 GB. You’ll also want more space to allow some room to work on the virtual machine. So 20 GB is a good recommendation.
  • CPU: Any CPU will do, but a processor which supports “Virtualization Technology” will be faster. You can check your computer CPU here.

Most machines produced in the last 4-5 years will meet these requirements.



Download Virtual Box for your platform, and install the software. On Windows run the installer, or on Ubuntu-like Linux systems do the following:

apt-get install virtualbox-ose

In addition download the OSGeo Virtual disk file (vmdk) from Click on the “Download virtual machine” button. Then unzip the downloaded file (using 7zip ).

Create a Virtual Machine

Start the VirtualBox application and click on the New button to create a new VM, and then Next.


Enter a name such as OSGeoLive, and choose Linux as the “Operating system”, and Ubuntu as the “Version”.


In the next screen set the memory to 1024 MB (or more if your host computer has more than 4GB, like in the screenshot below).


Continue to the next screen and choose “Use an existing virtual hard disk file”. Now click on the button (a folder icon) to browse to where you saved the OSGeoLive vmdk-file. Select this file, press Next and Create.


Config tips and tweaks

Once the VM is created, click on the Settings button. In the “General” section, go to the Advanced tab, and click to select “Show at top of screen” for the Mini toolbar.


Go to the “Display” section and increase video memory to 32 or 64 MB. In some host operating systems, it may be required to “Enable 3D Acceleration” for display to work properly.


In addition, move to the “Shared Folders” section, and click the “Add folder” (green + icon on the right) to find a directory on your host computer that you wish to share inside the VM.


You can choose to make the shared folder read-only, and auto-mounted. Once the “Folder path” and “Folder name” are defined, click OK, and again OK to finish and close the settings window.

Running the Virtual Machine

Now bootup the VM by clicking the Start (green arrow) button.

You should install the virtualbox guest additions, this will allow you to use full-screen mode.

sudo apt-get install --yes virtualbox-guest-dkms virtualbox-guest-utils virtualbox-guest-x11

When you install the iso on the VM, the username must be set to “user”

The user “user” is not a member of the “users” group on the OSGeoLive virtual machine. This prevents some tools from writing to its data directory and causes some software to fail to start.

The solution is to fix the vmdk with the following one-time procedure:

  1. Start a terminal.
  2. Run “sudo adduser user users”.
  3. Apply this change by starting a new desktop session: either restart the virtual machine or log out and log back in (username “user”, password “user”).

Also once the OSGeo system starts, add yourself to the vboxsf group so that the shared folders (defined above) are accessible by running in a terminal window:

user@osgeolive:~$ sudo usermod -a -G vboxsf user

In the above example, we defined a Shared Folder path on the host system and named it “GIS” in the VM Settings. The shared folder will appear in the file system under /media/sf_GIS/. To mount this folder in the user’s home directory, for example, in a terminal run:

user@osgeolive:~$ mkdir GIS

user@osgeolive:~$ sudo mount -t vboxsf -o uid=user,rw GIS /home/user/GIS

Now files on your host machine in the chosen folder will also be available in the VM in the “GIS” folder in user’s home directory.