TOC & Recently Viewed

Recently Viewed Topics

Nessuscli Agent

Use the nessuscli agent utility to perform some Nessus Agent functions through a command line interface.

Note: You must run all nessuscli agent commands as a user with administrative privileges.

Nessuscli Agent Syntax

Operating System



# /opt/nessus_agent/sbin/nessuscli agent <arg1> <arg2>

Mac OS X

# /Library/NessusAgent/run/sbin/nessuscli <arg1> <arg2>


C:\Program Files\Tenable\Nessus Agent


C:\ProgramData\Tenable\Nessus Agent

Run cmd.exe as administrator

Nessuscli Agent Commands

Command Description
Help Commands

# nessuscli agent help

Displays a list of Nessus Agent commands.

Bug Reporting Commands

# nessuscli bug-report-generator

Generates an archive of system diagnostics.

If you run this command without arguments, the utility prompts you for values.

Possible arguments:

--quiet: Run the bug report generator without prompting user for feedback.

--scrub: When in quiet mode, the bug report generator sanitizes the last two octets of the IPv4 address.

--full: When in quiet mode, the bug report generator collects extra data.

Local Agent Commands

Used to link, unlink, and display agent status

# nessuscli agent link --key=<key> --host=<host> --port=<port>

Using the Nessus Agent Linking Key, this command links the agent to the Nessus Manager or

Required arguments:




Optional arguments:








--proxy-agent=<agent> arguments:


# nessuscli agent unlink

Unlinks agent from the Nessus Manager or

# nessuscli agent status

Displays the status of the agent, jobs pending, and if the agent linked or not linked to server.

Example Status:

Agent linked
3 jobs pending

Agent not linked to a server

Agent is linked to
1 jobs pending

Fix Commands
# nessuscli fix --set update_hostname="<value>"

Updates agent hostnames in Nessus Manager or automatically.

The update_hostname parameter can be set to yes or no. By default, this preference is disabled.

Note: Restart the agent service for the change to take affect in Nessus Manager.

# nessuscli fix --set track_unique_agents="<value>"

Tracks unique agent assets by MAC address to prevent duplicates and outdated agents from appearing in Nessus Manager if a system is reinstalled.

The track_unique_agent parameter is available in Nessus 7.1.1 and can be set to yes or no. By default, this preference is enabled.

Copyright 2018 Tenable, Inc. All rights reserved. Tenable Network Security, Nessus, SecurityCenter, SecurityCenter Continuous View and Log Correlation Engine are registered trademarks of Tenable, Inc. Tenable,, Assure, and The Cyber Exposure Company are trademarks of Tenable, Inc. All other products or services are trademarks of their respective owners.