diff --git a/doc/upgrade.rst b/doc/upgrade.rst
index c5e1c0dfc..10546a141 100644
--- a/doc/upgrade.rst
+++ b/doc/upgrade.rst
@@ -766,6 +766,15 @@ Add the following settings to your ``settings.py`` file:
    REDIS_QUOTA_DB = 0
    REDIS_URL = 'redis://{}:{}/{}'.format(REDIS_HOST, REDIS_PORT, REDIS_QUOTA_DB)
 
+Or, if Redis listen on unix socket:
+
+.. sourcecode:: python
+
+   REDIS_HOST = '/path/to/redis/socket'
+   REDIS_PORT = 6379
+   REDIS_QUOTA_DB = 0
+   REDIS_URL = 'unix://{}?db={}'.format(REDIS_HOST, REDIS_QUOTA_DB)
+
 Once done, you can start the policy daemon using the following commands:
 
 .. sourcecode:: bash