CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY — CMake 4.3.0 Documentation

# CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

Added in version 3.16.

Controls searching the System Package Registry by the `find_package()` command.

By default this variable is not set and the behavior will fall back to that determined by the deprecated `CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY` variable. If that is also not set, then `find_package()` will use the System Package Registry unless the `NO_CMAKE_SYSTEM_PACKAGE_REGISTRY` option is provided.

This variable takes precedence over `CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY` when both are set.

In some cases, for example to locate only user specific installations, it is not desirable to use the System Package Registry when searching for packages. If the `CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY` variable is `FALSE`, all the `find_package()` commands will skip the System Package Registry as if they were called with the `NO_CMAKE_SYSTEM_PACKAGE_REGISTRY` argument.

See also Disabling the Package Registry.

See also the `CMAKE_FIND_USE_CMAKE_PATH`, `CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH`, `CMAKE_FIND_USE_INSTALL_PREFIX`, `CMAKE_FIND_USE_CMAKE_SYSTEM_PATH`, `CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH`, `CMAKE_FIND_USE_PACKAGE_REGISTRY`, and `CMAKE_FIND_USE_PACKAGE_ROOT_PATH` variables.