---
title: "Installing the Verax Endpoint Agent"
slug: "installing-the-verax-endpoint-agent"
updated: 2026-05-27T13:51:16Z
published: 2026-05-27T13:51:16Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.verax.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing the Verax Endpoint Agent

This guide explains how to download and install the Verax endpoint agent on Windows, macOS, and Linux.

The installer requires:

- An **Installation Token**
- The **Verax Server IP address**

You can obtain the installation token from your **Verax Protect Console** under:

**Settings → Desktop agent**

---

## Installer Parameters

All installers support the following parameters:

| Parameter | Description |
| --- | --- |
| `-t, --token` | Installation token |
| `-s, --server` | Verax server IP address |
| `-h, --help` | Show help information |

---

## Linux Installation

### Step 1 – Download the installer

```bash
curl -k -o verax_linux_installer.sh https://<VERAX_SERVER>:3000/assets/verax_linux_installer.sh
```

---

### Step 2 – Make the installer executable

```bash
chmod +x verax_linux_installer.sh
```

---

### Step 3 – Run the installer

```bash
sudo ./verax_linux_installer.sh -t <INSTALLATION_TOKEN> -s <VERAX_SERVER>
```

---

## macOS Installation

### Step 1 – Download the installer

```bash
curl -k -o verax_mac_installer.sh https://<VERAX_SERVER>:3000/assets/verax_mac_installer.sh
```

---

### Step 2 – Make the installer executable

```bash
chmod +x verax_mac_installer.sh
```

---

### Step 3 – Run the installer

```bash
sudo ./verax_mac_installer.sh -t <INSTALLATION_TOKEN> -s <VERAX_SERVER>
```

---

## Windows Installation

### Step 1 – Download the installer

Using PowerShell:

```powershell
curl.exe -k -o verax_windows_installer.bat https://<VERAX_SERVER>:3000/assets/verax_windows_installer.bat
```

---

### Step 2 – Run as Administrator

Right-click the file and select **Run as Administrator**, or execute from an elevated Command Prompt:

```plaintext
.\verax_windows_installer.bat -t <INSTALLATION_TOKEN> -s <VERAX_SERVER>
```

---

## Verifying Successful Installation

After installation:

- The agent registers automatically with the Verax server
- The endpoint will appear under:

**Settings → Desktop agents**
- Status should display as **Healthy**

---

## Troubleshooting

If the agent does not appear:

- Verify the installation token is correct
- Confirm the server address and port are reachable
- Ensure outbound access to the Verax server is allowed

For further assistance, contact your Verax administrator or Verax Support.