# HG changeset patch
# User Mads Kiilerich <mads@kiilerich.com>
# Date 2019-11-16 20:23:31
# Node ID fb0417c65c64a48d8f40cd57d8ffd8e4983ea561
# Parent  552f6738ace24fb56ffcf70cf460581a958049e8

docs: document official method for beaker cache cleanup

diff --git a/docs/usage/performance.rst b/docs/usage/performance.rst
--- a/docs/usage/performance.rst
+++ b/docs/usage/performance.rst
@@ -23,6 +23,15 @@ Caching
 Tweak beaker cache settings in the ini file. The actual effect of that is
 questionable.
 
+.. note::
+
+    Beaker has no upper bound on cache size and will never drop any caches. For
+    memory cache, the only option is to regularly restart the worker process.
+    For file cache, it must be cleaned manually, as described in the `Beaker
+    documentation <https://beaker.readthedocs.io/en/latest/sessions.html#removing-expired-old-sessions>`_::
+
+        find data/cache -type f -mtime +30 -print -exec rm {} \;
+
 
 Database
 --------