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

macOS Installation

Step 1 – Download the installer

curl -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>:3000

Windows Installation

Step 1 – Download the installer

Using PowerShell:

Invoke-WebRequest -Uri https://<VERAX_SERVER>:3000/assets/verax_windows_installer.bat -OutFile 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>:3000

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.