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 Layer | Description |
|---|---|
| Nginx Cache | Server-side page cache for fast response times |
| Cloudflare CDN | Global edge cache for worldwide delivery |
Cache by Environment
Different environments have different caching configurations:
| Environment | Caching Status | Why? |
|---|---|---|
| Development | Disabled | See changes immediately during development |
| QA | Enabled | Test real-world performance before production |
| Production | Enabled | Maximum performance for customers |
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
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
- Navigate to your store from the dashboard
- Click Settings in the sidebar
- 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.