docs(self-hosted): Document PyMemcachedCache breaking change

getsentry · Feb 8, 2024 · d286784 · d286784
1 parent 71fcd55
commit d286784
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/src/docs/self-hosted/releases.mdx b/src/docs/self-hosted/releases.mdx
@@ -80,3 +80,7 @@ These builds are usually stable, but you may occasionally hit a broken version a
 - The `23.11.0` release will remove the ``sentry run smtp`` worker process. This
   worker was not part of the standard self-hosted configuration, but could be
   used in custom deployments.
+
+- The `24.1.2` release will change the memcached backend from
+  `django.core.cache.backends.memcached.MemcachedCache` to
+  `django.core.cache.backends.memcached.PyMemcachedCache`. This will require changing the `CACHES` setting in your `sentry.conf.py` file in a manner similar to what is seen [here](https://github.com/getsentry/self-hosted/commit/9936376f4e933781feaae85e0071ef72c7f1c03f). In particular, the `OPTIONS` API for `PyMemcachedCache` is different from that of `MemcachedCache`, and may require changes depending on how it has been configured.