# Getting Started

## **Installation Instructions**

Installing OWASP Four Clover is a straightforward process. Follow these steps to get started:

<figure><img src="https://2163987224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHk85sSDVmiEuDJcCpuRY%2Fuploads%2FiUZUqYFRtrVRnFimXzL2%2FBigTvGIF.gif?alt=media&#x26;token=f165444f-549d-4afa-b1ff-29f147cc2454" alt=""><figcaption></figcaption></figure>

### **Step 1.  Download the Binary**

1. Go to the [GitHub Releases](https://github.com/fourclover-project/FourClover/releases) page for Four Clover.

{% embed url="<https://github.com/fourclover-project/FourClover/releases>" fullWidth="false" %}
OWASP Four Clover GitHub Repository
{% endembed %}

2. Choose the appropriate release version for your operating system (e.g., Windows, Linux, macOS).
3. Download the binary file for the release.

### **Step 2. Add to PATH (Optional)**

<details>

<summary>🪟 For Windows</summary>

#### **Locate Binary**

* After downloading the Four Clover binary, remember the directory where it's saved.

#### **Add to PATH**

* Press `Win + S` to open the Windows search bar.
* Type "Environment Variables" and select "Edit the system environment variables."
* In the System Properties window, click the "Environment Variables" button.
* Under "System variables," select the "Path" variable and click "Edit."
* Click "New" and add the directory path where the Four Clover binary is located.
* Click "OK" to save changes.

#### **Verify Installation**

* Open a new command prompt or PowerShell window.
* Run the following command to verify that Four Clover is accessible from anywhere:

```bash
fourclover version
```

</details>

<details>

<summary>🐧 For Linux/macOS</summary>

#### **Locate Binary and Add Executable Permissions**

* After downloading the Four Clover binary, remember the directory where it's saved.
* Navigate to the directory where you downloaded the binary.
* Run the following command to add executable permissions:

```bash
chmod +x fourclover
```

#### **Edit Bash Profile (Linux) or Bash Profile / Zshrc (MacOS)**

* Open a terminal.
* Run the following command to open the appropriate configuration file:

```bash
nano ~/.bashrc  # For Linux
nano ~/.bash_profile  # For MacOS
nano ~/.zshrc  # For MacOS (if using Zsh)
```

* Add the following line at the end of the file, replacing `/path/to/fourclover` with the actual path to the Four Clover binary:

```bash
export PATH=$PATH:/path/to/fourclover
```

* Press `Ctrl + O` to save the file, then press `Ctrl + X` to exit the text editor.

#### **Apply Changes**

* Run the following command in the terminal to apply the changes to your current session:

```bash
source ~/.bashrc  # For Linux
source ~/.bash_profile  # For MacOS
source ~/.zshrc  # For MacOS (if using Zsh)
```

**Verify Installation**

* Open a new terminal.
* Run the following command to verify that Four Clover is accessible from anywhere:

```bash
fourclover version
```

</details>

***

<figure><img src="https://2163987224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHk85sSDVmiEuDJcCpuRY%2Fuploads%2FXOEHRywpj3l2Gf8dGNyj%2FClappingJaredGIF.gif?alt=media&#x26;token=fafa4185-f10c-4b88-9362-1069ae99ca3d" alt=""><figcaption><p>Well done!</p></figcaption></figure>
