> 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/qualys-windows.md).

# Qualys - Windows

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

This guide walks you through installing the Qualys Cloud Agent 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 the Qualys Cloud Agent will be installed.
* Access to CybaOps so you can open Asset Manager.
* A working internet connection.

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

1. Sign in to CybaOps 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 Qualys and Select Operating System to Windows.
4. Click Download Qualys and save QualysCloudAgent.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 CustomerId and ActivationId 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 QualysCloudAgent.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 CybaOps and click the copy icon next to the install
\
command. Paste it into Command Prompt and press Enter. The command will look like this,
\
with your ActivationId in place of the placeholder:

{% code overflow="wrap" %}

```
.\QualysCloudAgent.exe CustomerId={4ced42b6-21b2-e6d5-80a3-bf1f6d2597f6}
ActivationId={YOUR ACTIVATION CODE}
WebServiceUri=https://qagpublic.qg1.apps.qualys.co.uk/CloudAgent/
```

{% endcode %}

{% hint style="info" %}
**Tip: Keep the curly braces { } around the values exactly as shown — Qualys requires**
\
**them on Windows. Copying directly from Deploy Agent avoids typos.**
{% endhint %}

### <mark style="color:$primary;">What the Parameters Mean</mark>

* **CustomerId** — identifies your Qualys subscription. This is the same for every device in
  \
  your organisation.
* **ActivationId** — identifies your Qualys activation key. This is the same for every device
  \
  in your organisation.
* **WebServiceUri** — the Qualys platform the agent reports into (UK platform in this
  \
  case).

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

The installer runs silently in the background — Command Prompt will return to a success
\
prompt when it finishes. The Qualys Cloud Agent will start communicating with the
\
platform 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
  \
  QualysCloudAgent.exe. Type dir to list files and check the folder, then re-run the cd
  \
  command in Step 2.
* **Activation rejected / agent doesn't appear** — Double-check the CustomerId and
  \
  ActivationId values, and make sure each is wrapped in curly braces. Copy and paste
  \
  from Deploy Agent rather than typing.
* **Connection error** — Confirm the PC has internet access and that no firewall is
  \
  blocking outbound HTTPS to qagpublic.qg1.apps.qualys.co.uk.

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