Appendix D. Command options for insights-client

download PDF

You can use the settings in the /etc/insights-client/insights-client.conf configuration file to change how the Insights client operates on your system.

D.1. Options for the Insights client configuration file

When the configuration file and the CLI have similar options, the CLI option is executed when you enter the insights-client command. When the scheduler runs the client, the configuration file options are executed.


You must enter the choices exactly as shown. True and False use initial capital letters.

To enable an option in the configuration file, remove the # as the first character of the line and provide a value for the option. The changes take effect either at the next scheduled run, or when you enter the insights-client command.

Table D.1. insights-client.conf configuration options


Required first line of the configuration file, even if you specify a different location or name for the client configuration file.


Change the log level. Options are: DEBUG, INFO, WARNING, ERROR, CRITICAL. The default is DEBUG. The default log file location is /var/log/insights-client/insights-client.log.


Attempt to auto configure with Satellite server. Values can be True (default) or False.


When auto_config=True (default), the authentication method used is CERT.


Set the authentication method. Valid option is CERT. The default value is CERT.


username to use when authmethod is BASIC. The username is stored in clear text.


password to use when authmethod is BASIC. The password is stored in clear text.

Base URL for the API.


URL for your proxy. Example: http://user:pass@


Automatically update the dynamic configuration. The default is True Change to False if you do not want to automatically update.


Obfuscate IPv4 addresses. The default is False. Change to True to enable address obfuscation.


Obfuscate hostname. You must set obfuscate=True to obfuscate the host name, which enables IPv4 address obfuscation. You cannot obfuscate only the host name.


Display name for registration. The default is to use /etc/hostname. NOTE: This value interacts with the insights-client --display-name command. If you use the CLI to change the display name but a different display name is enabled in the configuration file, the display name reverts to the configuration file value when the scheduler runs the Insights client.


Timeout for commands run during collection, in seconds. The command processes are terminated when the timeout value is hit.


Timeout for HTTP calls, in seconds


Location of redaction file

Insights client may prevent processes from initializing real-time scheduling.

Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.