Using-a-pre-built-virtual-machine.md

 We have prepared an Ubuntu Server virtual machine using the VirtualBox software.
 
+# Installing VirtualBox
+
 If you are using Linux, you can [install VirtualBox from the Oracle repository](https://linuxize.com/post/how-to-install-virtualbox-on-ubuntu-20-04/#installing-virtualbox-from-oracle-repositories).
 For a better experience, we recommend you [install the extension pack](https://linuxize.com/post/how-to-install-virtualbox-on-ubuntu-20-04/#installing-virtualbox-extension-pack) and the guest software on the virtual machine.
 *We did not include this software due to their [specific licensing terms](https://www.virtualbox.org/wiki/VirtualBox_PUEL).*
 
+# Downloading and setting up the VM image
+
+The virtual machine image can be downloaded [here](https://onu2.s2.chalmers.se/teraflow/TeraFlowDev-latest.rar). *Note that we may update the image with newer versions of relevant software during the project development.*
+
+Once downloaded, uncompress the image and [create a virtual machine using the image](https://blogs.oracle.com/oswald/importing-a-vdi-in-virtualbox).
+
+Note that it is important to give at least 2 virtual processors for the VM. Also, give it sufficient RAM (e.g., at least 2 GB).
+
+# Running the VM
+
+To log in, you have the username `teraflow` with the password `teraflow`.
+
 The virtual machine has the following software installed:
 - Default Ubuntu graphical user interface
 - Docker
 - Kubernetes
 - Visual Studio Code
 
-There is a `README` file on the Desktop of the virtual machine.
+There is a `README` file on the Desktop of the virtual machine. Take a look at it.
 
-The virtual machine image can be downloaded [here](https://onu2.s2.chalmers.se/teraflow/TeraFlowDev-latest.rar). *Note that we may update the image with newer versions of relevant software during the project development.*
+## TeraFlow OS
 
-Once downloaded, uncompress the image and [create a virtual machine using the image](https://blogs.oracle.com/oswald/importing-a-vdi-in-virtualbox).
+The TeraFlow OS git repository is already setup in the `/home/teraflow/Documents/teraflow/controller` folder. You can enter it and run `git pull` to get the latest version.
\ No newline at end of file
+
+# Contact
+
+If you have any suggestions regarding this page, feel free to reach out to us through our [contact page](https://www.teraflow-h2020.eu/form/contact).
\ No newline at end of file