Skip to content
DeviceQuest DeviceQuest DeviceQuest Docs User Documentation

Documentation

Agents

Install, connect, manage and remove the DeviceQuest host agent on Linux and Windows.

The DeviceQuest host agent runs on your servers and workstations. It collects inventory locally, runs scans from inside your network, and connects outbound to the agent gateway, so no inbound firewall rule is needed on the host.

  1. Agent overview: what the agent is, how it connects, what it collects and which commands it runs.
  2. Install on Linux: the one-command install, the manual install, the systemd service and how to verify it.
  3. Install on Windows: the PowerShell install, the install paths and the DeviceQuestAgent service.
  4. Remote SSH deploy: push the agent to a Linux asset from its asset page with an SSH credential.
  5. Kubernetes agent gateway: let agents on customer networks reach a Kubernetes deployment through the ingress on port 443.
  6. CLI reference: every subcommand, flag and environment variable of devicequest-agent.
  7. Updates, revoke and uninstall: update an agent, revoke an agent or a bootstrap credential, and remove the agent from a host.

In this section

01

Overview

Understand what the DeviceQuest host agent does, how it connects to the agent gateway, what it collects and which commands it runs.

02

Install on Linux

Enroll a Linux host with the one-command install or the manual install, and check that the devicequest-agent service is running.

03

Install on Windows

Enroll a Windows host with the PowerShell install command and check that the DeviceQuestAgent service is running.

04

Remote SSH deploy

Push the agent to a Linux asset from its asset page over SSH, with optional GPU telemetry, and follow each step until it enrolls.

05

Kubernetes gateway

Expose the agent gateway of a Kubernetes deployment through the ingress on port 443 so agents on customer networks can enroll with one command.

06

CLI reference

Every devicequest-agent subcommand, flag and environment variable, plus the control-plane settings that agents depend on.

07

Updates, revoke, uninstall

Update an agent to a new version, revoke an agent or a bootstrap credential, and remove the agent from a Linux or Windows host.