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

# FAQ

> Answers to the most common questions about Velatir for Desktop

## Overview

The most common questions we hear about Velatir for Desktop, grouped by topic. If your question is not here, [Troubleshooting](/desktop-app/troubleshooting) covers diagnosis, and your account team can help with anything operational.

## What it is and what it does

<AccordionGroup>
  <Accordion title="Does Velatir for Desktop cover AI in the browser?">
    Yes. Velatir for Desktop deploys the browser extension with your organisation's ingest key, so AI usage in web apps is covered from the same install. There is no separate product to deploy.
  </Accordion>

  <Accordion title="Which AI applications are covered?">
    In the browser, ChatGPT, Claude, Gemini, and thousands of other web platforms through the extension. On the device, the agent reports installed AI applications and launches of AI-native apps. Claude Code and Codex activity can be ingested over OpenTelemetry when that is enabled for your organisation. See [Overview](/desktop-app/overview). If you need coverage for an application that is not yet supported, request it through your account team.
  </Accordion>
</AccordionGroup>

## Installation and updates

<AccordionGroup>
  <Accordion title="How is it distributed?">
    An MSI for Windows and a PKG for macOS. Linux support is in development. See [Download and install](/desktop-app/download-and-install).
  </Accordion>

  <Accordion title="Can I install it silently for a whole organisation?">
    Yes. Microsoft Intune, Jamf Pro, and any MDM that deploys an MSI or PKG work out of the box. See [Enterprise deployment](/desktop-app/enterprise-deployment).
  </Accordion>

  <Accordion title="How are updates delivered?">
    The agent checks every four hours and updates itself automatically, with no update service to manage. You can apply one immediately with `velatir update --apply`.
  </Accordion>

  <Accordion title="Can I pin a specific version for change management?">
    Yes. Tenant-specific update channels are available for organisations that need to coordinate updates with their own change-management process. Contact support to enable this for your tenant.
  </Accordion>

  <Accordion title="How do I uninstall?">
    Use Add/Remove Programs on Windows (or `msiexec /x`), and `sudo velatir-uninstall` on macOS. See [Download and install](/desktop-app/download-and-install#updates-and-uninstall).

    Two things that route around it. On macOS with Firefox, the browser extension may remain listed after uninstall (it is inactive) and needs removing by hand. And if the uninstall is interrupted, your MDM cannot remove the app, or items remain afterwards, run the cleanup script in [Uninstall cleanup](/desktop-app/uninstall-cleanup) — devices on a version older than the current installer can leave artefacts a standard uninstall does not clear.
  </Accordion>
</AccordionGroup>

## Permissions and privacy

<AccordionGroup>
  <Accordion title="What permissions does it request?">
    Administrator rights at install time on both platforms. The full list with rationale is in [Permissions](/desktop-app/permissions).
  </Accordion>

  <Accordion title="Does it have access to my files, screen, microphone, or clipboard?">
    Velatir does not monitor your clipboard, screen, microphone, or files. It does not request Full Disk Access on macOS, and it does not capture screenshots or keystrokes.
  </Accordion>

  <Accordion title="What data is sent to Velatir?">
    Browser interactions become traces (prompt, response, model, token counts, and process context). On the device, the agent sends installed-app findings, launch events, heartbeats, and configuration state. What gets stored after review is governed by your agent configuration and your data privacy settings. See [Data privacy](/security/data-privacy).
  </Accordion>

  <Accordion title="Does it work offline?">
    Velatir needs to reach `api.velatir.com` to submit traces and heartbeats. If the device is offline it retries once connectivity returns; your AI applications keep working as normal in the meantime.
  </Accordion>
</AccordionGroup>

## Networking

<AccordionGroup>
  <Accordion title="What network access does it need?">
    The agent makes outbound HTTPS calls to `api.velatir.com` and Velatir's update storage. If a firewall or VPN blocks unknown destinations, allow those hosts. Your AI applications are unaffected.
  </Accordion>

  <Accordion title="What happens if something goes wrong?">
    The agent retries on its own. A problem with Velatir cannot take the device offline.
  </Accordion>
</AccordionGroup>

## Operations

<AccordionGroup>
  <Accordion title="How do I monitor it across a fleet?">
    Run `velatir status --json` or `velatir health --json` as a Microsoft Intune Remediation, a Jamf Pro extension attribute, or any similar device-state collector. The output includes the agent's status, version, and last update and config-sync outcomes.
  </Accordion>

  <Accordion title="How do I rotate ingest keys?">
    Redeploy the install command with the new key, or run `velatir set-api-key --key vltr_ingest_...` on the device. The new key takes effect immediately.
  </Accordion>

  <Accordion title="What does it look like for end users?">
    Nothing visible besides a tray icon. Supported AI applications work exactly as before, and users are not prompted during normal use. Behaviour changes only when an agent in **Enforcer** mode acts in the browser — for example blocking an interaction.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Download and install" icon="download" href="/desktop-app/download-and-install">
    Set Velatir up on Windows or macOS.
  </Card>

  <Card title="Enterprise deployment" icon="building" href="/desktop-app/enterprise-deployment">
    Roll out across your organisation.
  </Card>

  <Card title="Troubleshooting" icon="life-buoy" href="/desktop-app/troubleshooting">
    Diagnose the issues most commonly seen in production.
  </Card>

  <Card title="How it works" icon="layers" href="/desktop-app/how-it-works">
    How Velatir for Desktop works.
  </Card>
</CardGroup>