# HG changeset patch # User Mads Kiilerich # Date 2020-06-11 20:50:26 # Node ID 0bca9e828db247730518cbb4fd9225ea42592faf # Parent 850f096505aca2f22f086d94ed4043d98d95331f docs: mention the need for worker process restarts to avoid "memory leaks" (Issue #346) It might not be ideal to mention such details in the overview, but that seems like the best place for generic advice. (Kallithea should still aim for keeping memory growth under control.) diff --git a/docs/overview.rst b/docs/overview.rst --- a/docs/overview.rst +++ b/docs/overview.rst @@ -204,6 +204,14 @@ dynamically generated pages from a relat also often used inside organizations with a limited amount of users and thus no continuous hammering from the internet. +.. note:: + Kallithea, the libraries it uses, and Python itself do in several places use + simple caching in memory. Caches and memory are not always released in a way + that is suitable for long-running processes. They might appear to be leaking + memory. The worker processes should thus regularly be restarted - for + example after 1000 requests and/or one hour. This can usually be done by the + web server or the tool used for running it as a system service. + .. _Python: http://www.python.org/ .. _Gunicorn: http://gunicorn.org/