> 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-linux.md).

# Qualys - Linux

*<mark style="color:$info;">Installation on Linux (Debian and Fedora based)</mark>*

This guide walks you through installing the Qualys Cloud Agent on a Linux machine. The
\
steps cover both Debian-based distributions (Ubuntu, Debian, Linux Mint and similar) and
\
Fedora-based distributions (Fedora, RHEL, CentOS, Rocky, AlmaLinux). The whole process
\
takes about 2–3 minutes.

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

Make sure you have the following ready:

* An account with sudo privileges on the Linux machine.
* Knowledge of which family your distribution belongs to — Debian-based (.deb) or
  \
  Fedora-based (.rpm). If you're not sure, run cat /etc/os-release — Ubuntu, Debian and
  \
  Mint are Debian-based; Fedora, RHEL, CentOS, Rocky and Alma are Fedora-based.
* Access to CybaOps so you can open Asset Manager.
* A working internet connection.

## <mark style="color:$primary;">Step 1 — Download the Right Installer 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. Set Select Agent to Qualys.
4. Set Select Operating System to match your distribution: choose **Linux (Debian based)** for Ubuntu, Debian, Mint, etc., or **Linux (Fedora based)** for Fedora, RHEL, CentOS, Rocky, Alma.
5. Click Download Qualys and save the file (QualysCloudAgent.deb or QualysCloudAgent.rpm) to your Downloads folder.

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

## <mark style="color:$primary;">Step 2 — Open a Terminal</mark>

1. Open your terminal application (for example GNOME Terminal, Konsole, or any terminal you normally use).
2. Move into the folder where the installer was downloaded by typing the command below and pressing Enter:

{% code overflow="wrap" %}

```
cd ~/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 — Install the Package</mark>

Run the command that matches your distribution. Enter your login password when
\
prompted by sudo.

On a Debian-based distribution (Ubuntu, Debian, Mint, etc.):

{% code overflow="wrap" %}

```
sudo dpkg -i QualysCloudAgent.deb
```

{% endcode %}

On a Fedora-based distribution (Fedora, RHEL, CentOS, Rocky, Alma):

{% code overflow="wrap" %}

```
sudo rpm -ivh QualysCloudAgent.rpm
```

{% endcode %}

{% hint style="info" %}
**About the password prompt: When you run a sudo command, you'll be asked for your**
\
**login password. Type it and press Enter — the cursor won't appear to move while you**
\
**type, but the characters are being entered.**
{% endhint %}

## <mark style="color:$primary;">Step 4 — Activate the Agent</mark>

Copy the activation command from the Deploy Agent window in CybaOps and paste it into
\
the terminal. The command is the same for Debian-based and Fedora-based systems and
\
will look like this, with your ActivationId in place of the placeholder:

{% code overflow="wrap" %}

```
sudo /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh CustomerId=4ced42b6-21b2-
e6d5-80a3-bf1f6d2597f6 ActivationId=YOUR ACTIVATION CODE
ServerUri=https://qagpublic.qg1.apps.qualys.co.uk/CloudAgent/
```

{% endcode %}

Press Enter. The agent will register itself with the Qualys platform.

### <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** — the unique activation key Qualys uses to register this device.
* **ServerUri** — the Qualys platform the agent reports into (UK platform in this case).

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

The terminal will show progress messages while the activation runs. 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 terminal window at this point.

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

* **“Permission denied”** — Make sure you included sudo at the start of both the install
  \
  and activation commands.
* **“No such file or directory”** — You're not in the folder containing the installer. Run ls to
  \
  check, then re-run the cd command in Step 2.
* **Wrong package format** — If dpkg or rpm complains that the package isn't
  \
  supported, you've likely downloaded the wrong installer. Go back to Step 1 and pick
  \
  the other Linux option in Deploy Agent.
* **Missing dependencies on Debian-based** — If dpkg reports missing dependencies, run
  \
  sudo apt-get install -f to fix them, then re-run the install command.
* **Activation rejected / agent doesn't appear** — Double-check the CustomerId and
  \
  ActivationId values. Copy and paste from Deploy Agent rather than typing.
* **Connection error** — Confirm the machine 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 output
\
shown in the terminal — 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-linux.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.