# HG changeset patch
# User Mads Kiilerich <mads@kiilerich.com>
# Date 1573932211 -3600
# Node ID fb0417c65c64a48d8f40cd57d8ffd8e4983ea561
# Parent  552f6738ace24fb56ffcf70cf460581a958049e8
docs: document official method for beaker cache cleanup

diff -r 552f6738ace2 -r fb0417c65c64 docs/usage/performance.rst
--- a/docs/usage/performance.rst	Wed Nov 20 12:55:14 2019 +0100
+++ b/docs/usage/performance.rst	Sat Nov 16 20:23:31 2019 +0100
@@ -23,6 +23,15 @@
 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
 --------