The cloud policy of a SafeDep Cloud tenant can set the cooldown. Its value then wins over the config file, the environment variables and
--skip-dependency-cooldown. See Which settings the cloud policy changes. To exempt one package from the cloud cooldown, your security admin creates a trust entry with the scope cooldown.Set the window
dependency_cooldown.enabled to false.
Read the result
For npm, PyPI, and Cargo, PMG removes each version inside the window from the version list that the registry sends. When the version range allows an older version, the package manager installs it and PMG shows no message. PMG blocks the install in these cases:- Every version of the package is inside the window.
- You asked for an exact version, such as
pmg npm install pkg@1.2.3, and that version is inside the window.
Dependency cooldown and names each blocked package. When a dependency asks for an exact version inside the window, the package manager fails, and PMG lists the held-back versions after the error. Add --verbose to see the held-back versions on every install.
For npm and PyPI, the cooldown does not apply when the package manager downloads a locked version directly, such as npm ci with a lockfile.
For Go and Cargo, PMG also checks each download against the window, so a version from go.mod or Cargo.lock is checked too. PMG does not change the version list for Go. The go command picks the version, and PMG blocks the download when that version is inside the window.
Exempt a package
For a package that you must install as soon as it is published, such as your own SDK, add it to the skip list. Open the config file withpmg config edit and add an entry:
Skip the cooldown for one install
The cooldown is free in PMG. With SafeDep Cloud, you see every cooldown hold on the endpoints and CI runners of your team. See Query the PMG controls.
Next steps
For pip version requirements and thetrusted_packages list, see the dependency cooldown documentation in the PMG repository.
Alert on PMG blocks
With SafeDep Cloud, send malicious and cooldown blocks to Slack or a webhook.
Use PMG with a Private Registry or Mirror
Check packages from an internal registry.

