Added docs for provisioning the VM using Vagrant on Windows 10 without WSL

This commit is contained in:
Jan Beilicke 2020-11-26 22:59:11 +00:00
parent f20330c1f3
commit 5e3f7329d2

View file

@ -24,16 +24,6 @@ To provide a lightweight experience, the VM uses [XFCE](https://xfce.org/) as a
## Quickstart ## Quickstart
### Vagrant + Ansible on Windows 10 using Windows Subsystem for Linux
1. [Download](https://www.virtualbox.org/wiki/Downloads) and install Virtualbox ([Documentation](https://www.virtualbox.org/wiki/End-user_documentation))
2. Follow the [guide to install the Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10). This SATT guide assumes Ubuntu 18.04 LTS
3. Open Ubuntu through the Windows Start Menu
4. Inside the Ubuntu Terminal, continue the setup by following the next section.
### Vagrant + Ansible on Linux ### Vagrant + Ansible on Linux
1. Obtain Vagrant by [downloading the corresponding package](https://www.vagrantup.com/downloads.html) for your distribution, assuming Ubuntu in the next steps. 1. Obtain Vagrant by [downloading the corresponding package](https://www.vagrantup.com/downloads.html) for your distribution, assuming Ubuntu in the next steps.
@ -79,6 +69,30 @@ To provide a lightweight experience, the VM uses [XFCE](https://xfce.org/) as a
9. If everything went fine, you should be able to SSH into the machine by running `vagrant ssh` from within the same directory and the UI should work if you enabled it. 9. If everything went fine, you should be able to SSH into the machine by running `vagrant ssh` from within the same directory and the UI should work if you enabled it.
### Vagrant on Windows 10 (no Ansible required)
Vagrant will bootstrap a VM, install Ansible und run the provisioning from within the VM, i.e. the Vagrant host does not need to have any Ansible installed.
1. [Download](https://www.virtualbox.org/wiki/Downloads) and install Virtualbox ([Documentation](https://www.virtualbox.org/wiki/End-user_documentation))
2. Obtain Vagrant by [downloading and installing the corresponding package](https://www.vagrantup.com/downloads.html)
3. Clone this repository with Git or download and extract an archive
4. Open a Command Prompt or Powershell window and navigate to the checked out repository / extracted archive.
5. Run Vagrant with: `vagrant up` and wait patiently.
### Vagrant + Ansible on Windows 10 using Windows Subsystem for Linux
1. [Download](https://www.virtualbox.org/wiki/Downloads) and install Virtualbox ([Documentation](https://www.virtualbox.org/wiki/End-user_documentation))
2. Follow the [guide to install the Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10). This SATT guide assumes Ubuntu 18.04 LTS
3. Open Ubuntu through the Windows Start Menu
4. Inside the Ubuntu Terminal, continue the setup by following the next section.
## Default user ## Default user
By default, a `vagrant` user will be provisioned (if not already available) and used throughout the provisioning. The default password is `vagrant`. By default, a `vagrant` user will be provisioned (if not already available) and used throughout the provisioning. The default password is `vagrant`.