<commit_before># Docksal environment setup

!!! tip "This is a one time setup"
    Once you have a working Docksal environment in place, you can use it for all Docksal powered projects.

Installing Docksal on

- [Windows](#windows)
- [macOS](#macos)
- [Ubuntu Linux](#linux)

<a name="windows"></a>
## Installing Docksal on Windows

### 1. Install Babun

On Windows, you will need a Linux-type shell.

!!! danger "Install as a regular user"
    Babun should be installed and run **as a regular user** (do **NOT** run as Administrator to install).

Install [Babun](http://babun.github.io/) before proceeding and run all commands in it.
Docksal is not tested and not supported with other Linux-type shells on Windows.

### 2. Install VirtualBox

Install [VirtualBox 5.1.12 for Windows](http://download.virtualbox.org/virtualbox/5.1.12/VirtualBox-5.1.12-112440-Win.exe).

!!! attention "Specific version required"
    **Using the specified version is important.** If you use a different version, it may work fine or you may experience unexpected bugs. Fin will notify you to update your VirtualBox version in the future.

### 3. Install Docksal Fin

```bash
sudo curl -L https://raw.githubusercontent.com/docksal/docksal/master/bin/fin -o /usr/local/bin/fin && \
sudo chmod +x /usr/local/bin/fin
```

### 4. Install tools and configurations

```bash
fin update
```

### 5. Create and start the vm

```bash
fin vm start
```
[Help, my VM did not start!](../troubleshooting.md#failed-creating-docksal-virtual-machine)

### 6. Congratulations!

You are done with the one time environment installation. Now you can [configure your project](../getting-started/project-setup.md) to use Docksal or create a new pre-configured Drupal or Wordpress project with `fin create-site`.

!!! info "Experimental support for Native Docker applications"
    Advanced Docker users may want to check out how to use Docksal with [Native Docker applications](../getting-started/env-setup-native.md).

<a name="macos"></a>
## Installing Docksal on macOS

### 1. Install VirtualBox

Install [VirtualBox 5.1.12 for Mac](http://download.virtualbox.org/virtualbox/5.1.12/VirtualBox-5.1.12-112440-OSX.dmg).

!!! attention "Specific version required"
    **Using the specified version is important.** If you use a different version, it may work fine or you may experience unexpected bugs. Fin will notify you to update your VirtualBox version in the future.

### 2. Install Docksal Fin

```bash
sudo curl -L https://raw.githubusercontent.com/docksal/docksal/master/bin/fin -o /usr/local/bin/fin && \
sudo chmod +x /usr/local/bin/fin
```
<commit_msg>Update vbox link to 5.1.14 in docs<commit_after># Docksal environment setup

!!! tip "This is a one time setup"
    Once you have a working Docksal environment in place, you can use it for all Docksal powered projects.

Installing Docksal on

- [Windows](#windows)
- [macOS](#macos)
- [Ubuntu Linux](#linux)

<a name="windows"></a>
## Installing Docksal on Windows

### 1. Install Babun

On Windows, you will need a Linux-type shell.

!!! danger "Install as a regular user"
    Babun should be installed and run **as a regular user** (do **NOT** run as Administrator to install).

Install [Babun](http://babun.github.io/) before proceeding and run all commands in it.
Docksal is not tested and not supported with other Linux-type shells on Windows.

### 2. Install VirtualBox

Install [VirtualBox 5.1.14 for Windows](http://download.virtualbox.org/virtualbox/5.1.14/VirtualBox-5.1.14-112924-Win.exe).

!!! attention "Specific version required"
    **Using the specified version is important.** If you use a different version, it may work fine or you may experience unexpected bugs. Fin will notify you to update your VirtualBox version in the future.

### 3. Install Docksal Fin

```bash
sudo curl -L https://raw.githubusercontent.com/docksal/docksal/master/bin/fin -o /usr/local/bin/fin && \
sudo chmod +x /usr/local/bin/fin
```

### 4. Install tools and configurations

```bash
fin update
```

### 5. Create and start the vm

```bash
fin vm start
```
[Help, my VM did not start!](../troubleshooting.md#failed-creating-docksal-virtual-machine)

### 6. Congratulations!

You are done with the one time environment installation. Now you can [configure your project](../getting-started/project-setup.md) to use Docksal or create a new pre-configured Drupal or Wordpress project with `fin create-site`.

!!! info "Experimental support for Native Docker applications"
    Advanced Docker users may want to check out how to use Docksal with [Native Docker applications](../getting-started/env-setup-native.md).

<a name="macos"></a>
## Installing Docksal on macOS

### 1. Install VirtualBox

Install [VirtualBox 5.1.14 for Mac](http://download.virtualbox.org/virtualbox/5.1.14/VirtualBox-5.1.14-112924-OSX.dmg).

!!! attention "Specific version required"
    **Using the specified version is important.** If you use a different version, it may work fine or you may experience unexpected bugs. Fin will notify you to update your VirtualBox version in the future.

### 2. Install Docksal Fin

```bash
sudo curl -L https://raw.githubusercontent.com/docksal/docksal/master/bin/fin -o /usr/local/bin/fin && \
sudo chmod +x /usr/local/bin/fin
```

{'fraction_non_alphanumeric': 0.11769186821557799, 'fraction_numerical': 0.01752047229099219, 'mean_word_length': 4.0743961352657, 'pattern_counts': {'":': 0, '<': 11, '<?xml version=': 0, '>': 11, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6866951', 'n_tokens_mistral': 1677, 'n_tokens_neox': 1547, 'n_words': 618}