cPanel File Manager cache TTL limits and API invalidation

Answer to Your Questions

• Does changing filemanager_cache_ttl need a cPanel service restart? No. The value is read on every File Manager request, so the change takes effect immediately.
• Is there a documented minimum TTL for shared hosting? cPanel does not publish a hard minimum, but values below 60 s are discouraged because each refresh forces a fresh directory scan, which can spike CPU and I/O on busy shared accounts. A safe range is 120–300 s.
• Can we programmatically invalidate the cache after API‑driven file operations? The File Manager UI has no exposed endpoint for cache invalidation, but you can force a fresh lookup by making a “list” API call with a unique query string (e.g., ?_ts=123456). This bypasses the client‑side cache and returns the current directory contents.

Step‑by‑Step Guidance

1. Change the TTL

   • Log into WHM.
   • Navigate to Tweak Settings → File Manager.
   • Set filemanager_cache_ttl to the desired value (e.g., 180).
   • Save changes. The File Manager UI will reflect the new TTL without any service restart.

2. Verify the change

   • Open the File Manager in cPanel.
   • Check the “Cache TTL” indicator (if available) or simply observe that a refresh happens after the new interval.

3. Choose a safe TTL for shared hosting

   • Set the value to at least 120 s; 180–300 s is common for most shared environments.
   • Monitor server metrics (CPU, I/O) after applying a lower TTL to ensure it does not cause performance regressions.

4. Invalidate the cache after API operations

   • After creating, deleting, or moving a file via the cPanel API, add a dummy list call:
   • https://yourdomain.com:2083/execute?api.version=1&api.module=FileManager&api.action=list&path=/home/username/&_ts=123456
   • The ?_ts= parameter forces the File Manager to bypass its internal cache and return fresh directory contents.
   • Use the same approach in automation scripts to ensure the UI sees the latest state.

Diagnostics Needed

To tailor these recommendations precisely, please confirm your cPanel version. The filemanager_cache_ttl tweak and the cache‑bypass technique are documented for cPanel 96.x and later; earlier releases may behave differently.