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).
\ No newline at end of file
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.
# 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).
