From d6eb16a398a8d3a2f58399fd40df7f212680cab0 Mon Sep 17 00:00:00 2001 From: Michael Manfre Date: Mon, 5 Dec 2022 12:55:30 -0500 Subject: Added caching and initial settings --- docs/tuning.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'docs') diff --git a/docs/tuning.rst b/docs/tuning.rst index 2b5e5d8..6f7badc 100644 --- a/docs/tuning.rst +++ b/docs/tuning.rst @@ -14,3 +14,25 @@ Environment Variable: making remote requests to other Fediverse instances. This may also be a tuple of four floats to set the timeouts for connect, read, write, and pool. Example ``TAKAHE_REMOTE_TIMEOUT='[0.5, 1.0, 1.0, 0.5]'`` + + +Caching +-------- + +By default Takakē has caching disabled. The caching needs of a server can +varying drastically based upon the number of users and how interconnected +they are with other servers. + +Caching is configured by specifying a cache DSN in the environment variable +``TAKAHE_CACHES_DEFAULT``. The DSN format can be any supported by +`django-cache-url `_, but +some cache backends will require additional Python pacakages not required +by Takahē. + +**Examples** + +* LocMem cache for a small server: ``locmem://default`` +* Memcache cache for a service named ``memcache`` in a docker compose file: + ``memcached://memcache:11211?key_prefix=takahe`` +* Multiple memcache cache servers: + ``memcached://server1:11211,server2:11211`` -- cgit v1.2.3