NEST LIVE MEDIA Installation
=============================


Download and install a virtual machine if you do not already have one installed.

.. note::

   Although, the following instructions are for `Virtual Box <https://www.virtualbox.org/wiki/Downloads>`_, you can use a different virtual machine, such as `VMWare <http://www.vmware.com>`_.

For Linux users, it is possible to install Virtual Box from the package repositories.

Debian::

    sudo apt-get install virtualbox

Fedora::

    sudo dnf install virtualbox

SuSe::

    sudo zypper install virtualbox


Windows users can follow instructions on the website (see above).

NEST image setup
------------------

* Download the `NEST live medium <https://www.nest-simulator.org/downloads/gplreleases/NEST_2.20.0_Virtual_Box_lubuntu_18.04.ova>`_

* Start Virtual Box and import the virtual machine image "NEST_2.20.0_Virtual_Box_lubuntu_18.04.ova" (**File** > **Import Appliance**)

* Once imported, you can run the NEST image

* The user password is **nest**.

Notes
~~~~~~~~

* For better performance you can increase the memory for the machine **Settings** > **System** > **Base Memory**

* To allow fullscreen mode of the virtual machine you also need to increase the video memory above 16MB. (**Settings** > **Display** > **Video Memory**)

* If you need to share folders between the virtual machine and your regular desktop  environment, click on **Settings**. Choose **Shared Folder** and add the folder you wish to share. Make sure to mark **automount**.

* To install Guest Additions, select **Devices** > **Insert Guest Additions CD image...**  (top left of the VirtualBox Window). Then, open a terminal (Ctrl+Alt+t), go to "/media/nest/VBOXADDITIONS.../" and run "sudo bash VboxLinuxAdditions.run".

* To set the correct language layout for your keyboard (e.g., from "US" to "DE"), open a terminal and type: "sudo dpkg-reconfigure keyboard-configuration". After setting the correct keyboard map you have to reboot the system to activate the changes.