software/Semester-1.md

 # Overview of this page
+
 [[_TOC_]]
 
 # Problem Solving
@@ -30,9 +31,9 @@ No special actions required for the first few weeks.
 ### WebStorm and SSH-key
 
 - Make sure you followed the steps described [here.](software/ssh-keys)
-- This means you have 2 files: ``id_ed25519`` and ``id_ed25519.pub`` in a folder called ``.ssh`` in your homefolder (= this is the folder with your name of the user you logged in with on your computer).
-  * Verifiy this by opening ``git bash``
-  * Type ``ls ~/.ssh``
+- This means you have 2 files: `id_ed25519` and `id_ed25519.pub` in a folder called `.ssh` in your homefolder (= this is the folder with your name of the user you logged in with on your computer).
+  * Verifiy this by opening `git bash`
+  * Type `ls \~/.ssh`
   * You should see **at least** the 2 files
 - Open PhpStorm
   * If this is the first time opening PhpStorm choose **Configure > Settings** at the bottom right.
@@ -46,8 +47,6 @@ No special actions required for the first few weeks.
   * Passphrase: Only if you provided a passphrase in the ssh keys step.
   * Press **Test Connection** and this should work!
 
-
-
 # Programming Fundamentals TODO naar webstorm?
 
 ### PyCharm & Python
@@ -56,18 +55,16 @@ No special actions required for the first few weeks.
 - Python (version 3) - [Download](https://www.python.org/downloads/) - and follow the installation wizard. **Make sure to Add Python to PATH!**.
   * Python Path image ![Python path image](http://git.ti.howest.be/ti-public/kickoff/2020-2021/-/raw/master/images/python-path.png)
   * (If needed) At the top right (in yellow background) "Configure python interpreter > Add Interpreter" and click ok.
-
-
 - Jetbrains registration (see [General Software > Jetbrains registration](General-Software#jetbrains-stack)
-- Jetbrains - PyCharm: Go to [https://www.jetbrains.com/pycharm/](https://www.jetbrains.com/pycharm/) and scroll down for the **PyCharm Professional Edition**. Follow the installation wizard.
+- Jetbrains - PyCharm: Go to https://www.jetbrains.com/pycharm/ and scroll down for the **PyCharm Professional Edition**. Follow the installation wizard.
 - When using PyCharm, login with your email.
 
 ### PyCharm and SSH-key
 
 - Make sure you followed the steps described [here.](software/ssh-keys)
-- This means you have 2 files: ``id_ed25519`` and ``id_ed25519.pub`` in a folder called ``.ssh`` in your homefolder.
-  * Verifiy this by opening ``git bash``
-  * Type ``ls ~/.ssh``
+- This means you have 2 files: `id_ed25519` and `id_ed25519.pub` in a folder called `.ssh` in your homefolder.
+  * Verifiy this by opening `git bash`
+  * Type `ls \~/.ssh`
   * You should see **at least** the 2 files
 - Open PyCharm
   * If this is the first time opening PyCharm choose **Configure > Settings** at the bottom right.
@@ -82,16 +79,18 @@ No special actions required for the first few weeks.
   * Press **Test Connection** and this should work!
 
 ### Demo code TODO:
+
 [Here](https://git.ti.howest.be/TI/2020-2021/s1/programming-fundamentals) you can find the repo for Programming Fundamentals.
 
 Click on 'demo code', and look for the clone button. You can copy (ssh-)url to your clipboard and start up PyCharm. In the start screen, select "Get from version control", select git (the default) and paste the url. Hit clone and it should create a fresh Python-project on your device. Open the `main.py` file, right-click and find the green arrow. If you click this arrow, the program should run and print "Hello World to the screen. You are ready not ready to take Programming Fundamentals. Later we will study later how you can get the latest version for every session.
 
-
 # Hardware and Desktop Operating Systems
 
 - **VMware Workstation Pro**
+
+
 * (If you work on a Mac, it is called VMware Fusion)
-  * Go to [https://nas.ti.howest.be](https://nas.ti.howest.be)
+  * Go to https://nas.ti.howest.be
   * Login with your **Howest credentials** (email **without** @student.howest.be) and password
   * Navigate to "TI-S0-General" > "Virtualization-VMware".
   * Download the exe file (or the .dmg if you use u Mac) and open the "serials.txt"-file (we will need this in a minute)
@@ -103,13 +102,90 @@ Click on 'demo code', and look for the clone button. You can copy (ssh-)url to y
     - Press License before Finish
     - Copy the License key (from the serials.txt-file)
   * Restart your system
+
+
 - **Download Windows 10 ISO**
-  * Go to [https://nas.ti.howest.be](https://nas.ti.howest.be)
+  * Go to https://nas.ti.howest.be
   * Login with your **Howest credentials** (email **without** @student.howest.be) and password
   * Navigate to "TI-S1-HardwareAndOperatingSystems".
   * Download the iso and put it on a nice location (for example Documents folder) do not download the .iso to a synced folder (for example Google Drive or OneDrive)!
   * **Only download! No further actions are required!!**
 
+# Web Development Essentials
+
+## **Vagrant box - Homestead**
+
+- **prerequisites:**
+  - Git (see [General Software > Git](General-Software#git))
+  - SSH-key:
+    - Make sure you followed the steps described [here.](software/ssh-keys)
+    - This means you have 2 files: `id_ed25519` and `id_ed25519.pub` in a folder called `.ssh` in your homefolder (= this is the folder with your name of the user you logged in with on your computer).
+      - Verifiy this by opening `git bash`
+      - Type `ls \~/.ssh`
+      - You should see **at least** the 2 files
+- **download and install Vagrant:**
+  - https://www.vagrantup.com/downloads
+- **download and install Virtual Box:**
+  - https://www.virtualbox.org/wiki/Downloads
+- **clone and install Homestead:**
+  - Open the command line or Git Bash terminal and execute the commands below in **your documents folder**.
+
+    ```bash
+        >> git clone https://github.com/laravel/homestead.git Homestead
+        >> cd Homestead
+        >> git checkout release
+    ```
+  - Next, execute the bash init.sh command from the Homestead directory to create the Homestead.yaml configuration file.
+
+    ```bash
+        # macOS / Linux...
+        >> bash init.sh
+        
+        # Windows...
+        >> init.bat
+    ```
+  - Update the properties **authorize** and **keys** in your Homestead.yaml file with:
+
+    ```yaml
+        authorize: ~/.ssh/id_ed25519.pub
+        keys:
+            - ~/.ssh/id_ed25519
+    ```
+- **test the installation:**
+  - Launching the Homestead Box:
+    - Run the **vagrant up** command from your Homestead directory, to boot your Homestead box. _When you run the **vagrant up** command for the first time, and only then, it will start with downloading the Homestead box._
+
+      ```bash
+          >> vagrant up
+      ```
+    - Run the **vagrant ssh** command from your Homestead directory, to login into your Homestead box.
+
+      ```bash
+          >> vagrant ssh
+      ```
+  - Logout from the Homestead Box:
+    - Terminate the SSH session with the **exit** or **logout** command.
+
+      ```bash
+          # exit 
+          vagrant@vagrant:~$ exit
+      
+          # or
+          # logout
+          vagrant@vagrant:~$ logout
+      ```
+  - Make sure you shut down the running Homestead Box after using it:
+    - Run the **vagrant halt** command from your Homestead directory, to shut down your Homestead box.
+
+      ```bash
+          >> vagrant halt
+      ```
+- **More information or troubleshooting:**
+
+  If there are teachers around, go ahead and ask! :)
+
+  Otherwise, this might help: https://laravel.com/docs/9.x/homestead
+
 # Congratulations
 
 Pfew! We are done. You (and your computer) are ready to start! :)
\ No newline at end of file