Download and Install

Documentation Index

Fetch the complete documentation index at: https://docs.velatir.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Prerequisites

• Windows
• macOS

​

Install on Windows

Download the installer

Download the latest signed MSI:

Velatir for Windows (x64)

For Intel and AMD devices.

Velatir for Windows (arm64)

For Snapdragon and other arm64 devices.

The MSI is signed by Velatir. SmartScreen may prompt the first time it sees a new version; click More info > Run anyway.

Run the installer

Double-click the MSI and follow the prompts. The installer will:

• Place the Velatir Agent into C:\Program Files\Velatir\
• Install the Velatir CA certificate into the trusted root store
• Register the Wintun driver used for transparent traffic interception
• Register a scheduled task that starts the agent at user logon

You will be prompted to elevate to administrator. The full list of permissions is documented in Permissions.

Sign in with your API key

Open a new PowerShell or Command Prompt window and configure your API key:

velatir set-api-key --key vltr_your_api_key_here

The host will restart automatically. Verify the agent is running:

velatir status

Confirm interception

Open a supported AI application (for example, GitHub Copilot in VS Code or Claude Code in a terminal). Send a prompt, then check your Velatir dashboard. The interaction should appear as a trace within a few seconds.

​

Silent install

For unattended installation, install the MSI quietly and stage the API key in one command:

msiexec /i Velatir-Bootstrap-x64.msi /qn VELATIR_API_KEY=vltr_your_api_key_here

The VELATIR_API_KEY property is hidden from MSI logs. See Enterprise deployment for full Intune and Group Policy guidance.

​

Install on macOS

Download the installer

Download the package for your Mac’s architecture:

Velatir for macOS (Apple Silicon)

For Mac computers with Apple Silicon (M1, M2, M3, M4 and later).

Velatir for macOS (Intel)

For Mac computers with an Intel processor.

Not sure which one you need? Click the Apple menu, choose About This Mac, and check the Chip or Processor entry. If it mentions Apple, M1, M2, M3, or M4, choose Apple Silicon. If it mentions Intel, choose Intel.The package is signed by Velatir’s Apple Developer ID and notarised by Apple, so Gatekeeper will allow it to run without warnings.

Run the installer

Open the downloaded .pkg and follow the prompts. The installer will:

• Place Velatir into /Applications/Velatir.app
• Register the Velatir system extension
• Install the Velatir CA into the System keychain

Authentication with an administrator password is required to complete the install. No other inputs are required during the installer flow.

Configure your API key

Open a new Terminal window and set the API key. Generate one in the Velatir dashboard under Settings > API Keys.

sudo velatir set-api-key --key vltr_your_api_key_here

The default backend points at production. Change it only if directed by your administrator:

sudo velatir set-api-base-url --url https://api.velatir.com/api/v1

Approve the system extension

macOS will prompt you to approve the Velatir system extension. Open System Settings > General > Login Items & Extensions > Network Extensions (or use the link that appears in the prompt), and enable Velatir.Until the extension is approved, Velatir cannot intercept traffic. Approval is required once per device.

Verify the agent is running

In the same Terminal, check the agent state:

velatir status

The status output should show the agent and host running, the transparent proxy active, and a masked API key matching the value you set in step 3.

Confirm interception

Open a supported AI application (for example, Claude Code in a terminal, or GitHub Copilot in VS Code). Send a prompt, then check your Velatir dashboard. The interaction should appear as a trace within a few seconds.

​

What Gets Installed

​

Updates

velatir update --apply

​

Uninstall

msiexec /x {VELATIR-PRODUCT-CODE-PLACEHOLDER} /qn

sudo /Applications/Velatir.app/Contents/Resources/uninstall.sh

​

Next Steps