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

Prev Next

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

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

Step 2 – Make the installer executable

chmod +x verax_linux_installer.sh

Step 3 – Run the installer

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

macOS Installation

Step 1 – Download the installer

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

Step 2 – Make the installer executable

chmod +x verax_mac_installer.sh

Step 3 – Run the installer

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

Windows Installation

Step 1 – Download the installer

Using 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:

.\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.