Skip to main content

Cache Management Overview

Understanding how caching works in Urumi and when to clear caches.

What is Caching?

Caching stores copies of your site's content to serve pages faster. Urumi uses multiple cache layers:

Cache LayerDescription
Nginx CacheServer-side page cache for fast response times
Cloudflare CDNGlobal edge cache for worldwide delivery

Cache by Environment

Different environments have different caching configurations:

EnvironmentCaching StatusWhy?
DevelopmentDisabledSee changes immediately during development
QAEnabledTest real-world performance before production
ProductionEnabledMaximum performance for customers
Development Environment

Caching is intentionally disabled in Development so you can see code changes immediately without clearing cache.

Automatic Cache Clearing

Urumi automatically clears cache during deployments. When you push changes to Development, QA, or Production, the cache is cleared automatically as part of the deployment process.

You typically don't need to manually clear cache unless:

  • You're troubleshooting display issues
  • You made changes outside the deployment flow
  • You're using a custom CDN that needs separate cache clearing
Custom CDN Users

If you're using a custom CDN (like your own Cloudflare account or another provider), you may need to clear cache on your CDN separately after deployments.

When to Clear Cache Manually

Clear the cache when:

  • Changes aren't appearing after deployment (try this first before troubleshooting further)
  • Using a custom CDN - Clear your CDN's cache separately
  • Troubleshooting - To rule out cached content issues
  • After direct database changes - Changes made outside normal deployment flow

What Gets Cleared

When you clear cache for an environment:

  • Nginx cache - All server-cached pages for that environment
  • Cloudflare cache - All Urumi CDN-cached assets

Both caches are cleared simultaneously with a single button click.

Accessing Cache Settings

  1. Navigate to your store from the dashboard
  2. Click Settings in the sidebar
  3. Select Cache from the settings menu

Or access from the Deploy tab where each environment card has a cache clear button.

Cache Clearing Locations

Cache can be cleared from two places:

Cache Settings Page

Go to Settings > Cache for a dedicated page showing all environments and their cache status.

Deploy Tab

On the Deploy tab, QA and Production environment cards have cache clear buttons (archive icon) for quick access.