Manage cnquery Providers

Providers are the components of cnquery that allow it to query specific platforms. By default, cnquery automatically manages providers for you. To learn more, read About cnquery Providers.

Available providers

You can download the latest versions of providers at https://releases.mondoo.com/providers/. Past versions are always available at the same location.

List installed providers

To see what providers are installed:

cnquery providers

Install a provider

To install a provider:

cnquery providers install NAME

For NAME, substitute the provider name from the table above. For example:

cnquery providers install k8s

To install from a file:

cnquery providers install -f PATH

For example:

cnquery providers install -f providers/os/dist/os.tar.xz

To install from a URL:

cnquery providers install --url URL

For example:

cnquery providers install --url https://releases.mondoo.com/providers/os/9.0.7/os_9.0.7_linux_arm.tar.xz

Update providers

To update all installed providers to the latest version:

cnquery providers update

To update a specific provider:

cnquery providers update NAME

For example:

cnquery providers update vsphere

Remove a provider

To remove a provider:

cnquery providers remove NAME

For example:

cnquery providers remove terraform

Disable automatic provider updates

By default, each time you run a cnquery command, cnquery downloads the latest version of the provider needed (unless it's already installed). You can change this behavior.

Disable for all commands

To disable automatic updates, set the auto-update value in the cnquery configuration file to false.

On Linux or macOS, cnquery configuration is stored in one of these locations:

• /etc/opt/mondoo/mondoo.yml — configures cnquery for all user accounts
• ~/.config/mondoo/mondoo.yml — configures cnquery for a single user

On Windows:

• C:\ProgramData\mondoo\mondoo.yml — configures cnquery for all users
• C:\Users\{username}\.config\mondoo\mondoo.yml — configures cnquery for a single user

Add this setting:

auto-update: false

Disable for a single command

To skip checking for provider updates for a single command, add the --auto-update=false flag:

cnquery scan --auto-update=false

The command line flag overrides the mondoo.yml configuration file setting.