From 945bef78a184fe58eaff8979602f31f5585e397a Mon Sep 17 00:00:00 2001
From: Xavier Petit <32063953+xpetit@users.noreply.github.com>
Date: Fri, 29 Nov 2019 10:37:17 +0000
Subject: [PATCH] Add Ubuntu Virtual Box installation instructions

---
 docs/ubuntu-persistent-installation.md | 42 ++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/ubuntu-persistent-installation.md

diff --git a/docs/ubuntu-persistent-installation.md b/docs/ubuntu-persistent-installation.md
new file mode 100644
index 000000000..bd9e47eec
--- /dev/null
+++ b/docs/ubuntu-persistent-installation.md
@@ -0,0 +1,42 @@
+# Ubuntu
+
+## OS Installation
+
+Install the latest version of [Virtual Box](https://www.virtualbox.org/wiki/Downloads).
+
+> The text instructions are more important than the screenshots
+
+Screenshots of the installation of Ubuntu in Virtual Box are [here](https://github.com/xpetit/vbox-ubuntu-install/blob/master/README.md).
+
+Download and boot the [last Ubuntu release](http://releases.ubuntu.com/19.10/ubuntu-19.10-desktop-amd64.iso).
+
+- Create a new virtual machine named "Ubuntu" with at least 4096 MB of RAM
+- Use the fixed size storage allocation (to have more performance)
+- In the settings of the VM
+    - System -> Motherboard : check "Enable EFI"
+    - System -> Processor : Select at least 2 processors
+    - Display -> Screen : Put "Video Memory" to the maximum
+        - Enable 3D acceleration
+    - Storage
+        - Remove IDE controller
+        - Add Optical Drive to the SATA controller
+            - Choose your Ubuntu ISO image
+    - Close the settings (click OK)
+- Run the VM
+
+Follow the screenshots (some settings can be personalized, such as keyboard layout, location, password, login automatically, but **do not change the username**)
+
+Skip the welcoming window.
+
+Don't install updates if Ubuntu asks to. The scripts will.
+
+## OS configuration
+
+Run a terminal and type these commands :
+
+```shell
+unset HISTFILE
+sudo apt-get -y install curl
+export PERSISTENT=
+bash <(curl -sSL raw.githubusercontent.com/01-edu/public/master/scripts/kickstart.sh)
+```