# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fourclover.org/v0.1/overview/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.