Customer CDN Download Cache (Licensed Editions Only)
Chocolatey offers a customer CDN cache of download content for customers! The internet is unpredictable and sometimes sites go down, the cache ensures that the packages on the community repository are not broken by issues with the internet. We lovingly call this the "No more 404s feature".
We do this by caching a copy of the content on our private CDN. This content also gets virus checked and checksummed to verify that it matches what was originally intended by package maintainers and moderators for you to receive.
- Important Information for Software Vendors
- Options and Switches
- How do I take advantage of this feature?
- I'm a licensed customer, now what?
- How do I turn this feature on?
- How do I turn this feature off?
- Is the content modified?
- Is the content publicly available?
- Why isn't a cache available for x package?
- Does this grant me a license to the software?
- I'm a vendor and wish to opt out.
Important Information for Software Vendors
When our customers download content from you, we may cache a copy of that content on our customer CDN to ensure that later our licensed customers will be able to access that content again. This allows predictable and reliable installations of packages. Like most CDNs, no changes are made, we are simply ensuring the content stays available for our private customers. We are not modifying, selling, renting, leasing, lending, or sub-licensing this content in any way.
This private content cache is only available as a service for our licensed customers.
If you have questions or prefer to opt out, please contact us and select "Software Vendor Opt Out" (vendor requests only please).
This is mostly automatic, but in case the feature is turned off, you may turn it on by setting the feature
choco feature enable -n downloadCache).
To see if a package has content cached on the CDN, you can run
choco info packagename and it will give you detailed information pertaining to a package.
When you install, you will see a message similar to the following when the cached content is used:
Options and Switches
downloadCache- Download Cache - use the private download cache if available for a package.
choco install /
choco upgrade provide the following option(s):
--sdc, --skipdownloadcache, --skip-download-cache Skip Download Cache - Use the original download even if a private CDN cache is available for a package. Overrides the default feature 'downloadCache' set to 'True'. Available in 0.9.10+. Licensed versions only. --dc, --downloadcache, --download-cache, --use-download-cache Use Download Cache - Use private CDN cache if available for a package. Overrides the default feature 'downloadCache' set to 'True'. Available in 0.9.10+. Licensed versions only.
How do I take advantage of this feature?
You must have a licensed edition of Chocolatey (Pro, MSP, or Business) and use the community package repository to install/upgrade packages. Pro is a personal, named license that costs about the price of a lunch outing per month and comes with several other features. Business editions are great for organizations that need to manage the total software management lifecycle. MSP editions are for managed service providers and contain the same features as Pro (minus VirusTotal integration).
I'm a licensed customer, now what?
When you install packages from the community repository and a private cache becomes available, it will use that cache automatically. You don't have to do anything additional.
How do I turn this feature on?
- Globally -
choco feature enable -n downloadCache
- Per command - use the switch
--use-download-cachewith install/upgrade commands.
How do I turn this feature off?
- Globally -
choco feature disable -n downloadCache
- Per command - use the switch
--skip-download-cachewith install/upgrade commands.
Is the content modified?
No, this is the original content as it would have been downloaded.
Is the content publicly available?
No, this is a private CDN cache available only for licensed customers.
Why isn't a cache available for x package?
There are a variety of factors that go into suitability for a package.
- If the software vendor has opted out, there will be no cache for a package that uses that software.
- If the package doesn't actually download anything, there will be no cache.
- If the package downloads resources, but not in the recommended way, there may not be a cache available.
Does this grant me a license to the software?
No, you still need to work with the software vendor to obtain a license, if required.
I'm a vendor and wish to opt out.
Please see important information for software vendors.