Skip to main content
To improve performance of your Spree application, we recommend using a CDN (Content Delivery Network) to cache images and static files.
If you also cache Store API responses at the CDN, the cache key must include every header in the response’s Vary header — see HTTP caching of Store API responses.
We recommend using Cloudflare as your CDN provider. It’s free and simple to set up. After setting up your Cloudflare account and adding your domain name to Cloudflare, you will need to set your cache settings. Go to your domain name in Cloudflare and click on “Caching” tab and select “Cache Rules”. Cloudflare Cache Rules Click on “Create Rule” and set up the rule as below: Cloudflare Cache Rule Settings Supply the first value with
and the second value with
This will handle caching of both images and static files such as JavaScript and CSS files. Now scroll down and set the settings as below: Cloudflare Cache Rule Settings Finally, click on “Deploy” and you are done!

​
Dedicated CDN Host

The setup above caches on your primary domain and needs no extra configuration. If you instead serve assets and images from a separate CDN hostname (e.g. a CloudFront or Fastly distribution at cdn.example.com with your app as the origin), set the CDN_HOST environment variable:
Static asset URLs and image/attachment URLs (including those in API responses) will then use this host instead of SPREE_HOST. Host only, no protocol — URLs keep the scheme of your primary host.