Cloud Agent Installation Steps

Perform the following steps to install the Cloud Agent on a host asset.

Copy the downloaded Cloud Agent installer package on a host asset.
Run the following installation command in the command prompt with root privileges (For x64). The installation command may vary depending on the type of installer package (x64 or ARM64).

For Linux (.rpm) Package

> sudo rpm -ivh qualys-cloud-agent.x86_64.rpm

> sudo /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx CustomerId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ServerUri=<qualys_pod_url>/CloudAgent
For Linux (.deb) Package

> sudo dpkg --install qualys-cloud-agent.x86_64.deb

> sudo /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx CustomerId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ServerUri=<qualys_pod_url>/CloudAgent

For RPM based packages, if you do not import the GPG signing key, the NOKEY warning is displayed during installation.

Refer to Cloud Agent Package Integrity to learn more about GPG signing key.

Replace the activation ID and customer ID with the one you saved while downloading the Cloud Agent.

How to Install FedRAMP-compliant build

Use the following commands to install FedRAMP-compliant Cloud Agent:

For Linux (.rpm) Package

> sudo rpm -ivh qualys-cloud-agent.x86_64.rpm

> sudo /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx CustomerId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ServerUri=https://qualysguard.gov1.qualys.us/CloudAgent /FEDRAMP=true

For Linux (.deb) Package

> sudo dpkg --install qualys-cloud-agent.x86_64.deb

FedRAMP-compliant Cloud Agents can be installed only on the GOV1 Platform (https://qualysguard.gov1.qualys.us/). These agents are not supported for other Qualys platforms.

Last updated: May, 2026