> For the complete documentation index, see [llms.txt](https://docs.cybaops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cybaops.com/getting-started/onboarding/agent-deployment/cybaagent-windows.md).

# CybaAgent - Windows

*<mark style="color:$info;">Command-line installation on Windows</mark>*

This guide walks you through installing CybaAgent on a Windows PC using Command
\
Prompt. The installation takes about 2–3 minutes.

### <mark style="color:$primary;">Before you Start</mark>

Make sure you have the following ready:

* Administrator rights on the PC where CybaAgent will be installed.
* Access to the CybaOps portal so you can open Asset Manager.
* A working internet connection.

## <mark style="color:$primary;">Step 1 — Download CybaAgent from Asset Manager</mark>

1. Sign in to the CybaOps portal and open Asset Manager.
2. Click the Deploy Agent button in the top-right corner.
3. In the Deploy Agent window, set Select Agent to CybaAgent and Select Operating System to Windows.
4. Click Download Agent and save CybaAgent.exe to the Downloads folder (the default location is fine).

{% hint style="warning" %}
**Keep this window open: The Deploy Agent window also shows your install command**
\
**with your activation code pre-filled — you'll copy it in Step 3.**
{% endhint %}

## <mark style="color:$primary;">Step 2 — Open an Administrator Command Prompt</mark>

1. Press the Windows key on your keyboard.
2. Type cmd.
3. Right-click Command Prompt in the search results and choose Run as administrator.
4. If Windows asks for permission, click Yes.

Now switch to the folder where CybaAgent.exe was downloaded. If you used the default
\
location, type the following and press Enter:

{% code overflow="wrap" %}

```
cd C:\Users\%USERNAME%\Downloads
```

{% endcode %}

(If you saved the file somewhere else, use cd followed by the full path to that folder instead.)

## <mark style="color:$primary;">Step 3 — Run the Install Command</mark>

Go back to the Deploy Agent window in the portal and click the copy icon next to the install
\
command. It will look like this, with your unique activation code in place of the placeholder:

{% code overflow="wrap" %}

```
.\CybaAgent.exe -i -t tt-YOURACTIVATIONCODE -s https://cybaverse.cybaops.com/
```

{% endcode %}

Paste the command into the Command Prompt window and press Enter.

{% hint style="info" %}
**Tip: Always copy the command directly from Deploy Agent rather than typing it — that**
\
**way your activation code is guaranteed to be correct.**
{% endhint %}

### <mark style="color:$primary;">What the Command Does</mark>

* .\CybaAgent.exe — runs the installer in the current folder.
* -i — tells CybaAgent to install itself.
* -t tt-UNIQUEACTIVATIONCODE — your unique activation token, used to register the
  \
  agent to your account.
* -s <https://cybaverse.cybaops.com/> — the server CybaAgent will report into.

## <mark style="color:$primary;">Step 4 — Confirm it Installed</mark>

Command Prompt will show progress messages while the installer runs. When it finishes,
\
CybaAgent is installed and will start communicating with the server automatically. The
\
device should also appear in Asset Manager shortly afterwards.

You can close the Command Prompt window at this point.

### <mark style="color:$primary;">Troubleshooting</mark>

* **“Access is denied”** — Make sure you opened Command Prompt as administrator
  \
  (Step 2).
* **“The system cannot find the file specified”** — You're not in the folder containing
  \
  CybaAgent.exe.
* **Activation code rejected** — Double-check the code and make sure it starts with tt-.
  \
  Copy and paste it rather than typing it to avoid mistakes.
* **Nothing happens / connection error** — Confirm the PC has internet access and that
  \
  no firewall is blocking outbound HTTPS to cybaverse.cybaops.com.

### <mark style="color:$primary;">Need Help?</mark>

If the install still won't complete, contact our support team and include the full text shown
\
in Command Prompt — that helps us identify the issue quickly.

Please contact <support@cybaops.help> for assistance.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cybaops.com/getting-started/onboarding/agent-deployment/cybaagent-windows.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.