From d71cac498138ddd86f18607b9043e70286ea884a Mon Sep 17 00:00:00 2001
From: Aslak Raanes <aslakr@gmail.com>
Date: Tue, 13 Jul 2021 20:32:49 +0200
Subject: [PATCH] How to configure Unix domain sockets with Apache

Example on how to use Unix domain socket option on Apache. Not testet.

(Usually I would have used [`ProxyPassReverse`](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypassreverse) in combination with `ProxyPass` , i.e.

```apache
ProxyPass /my-datasette/ http://127.0.0.1:8009/my-datasette/
ProxyPassReverse /my-datasette/ http://127.0.0.1:8009/my-datasette/
```

and

```apache
ProxyPass /my-datasette/ unix:/tmp/datasette.sock|http://localhost/my-datasette/
ProxyPassReverse /my-datasette/ unix:/tmp/datasette.sock|http://localhost/my-datasette/
```
---
 docs/deploying.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/deploying.rst b/docs/deploying.rst
index 3be36df4..c471fad6 100644
--- a/docs/deploying.rst
+++ b/docs/deploying.rst
@@ -188,4 +188,8 @@ Then add these directives to proxy traffic::
     ProxyPass /my-datasette/ http://127.0.0.1:8009/my-datasette/
     ProxyPreserveHost On
 
+Using ``--uds`` you can use Unix domain sockets similiar to the Nginx example:
+
+    ProxyPass /my-datasette/ unix:/tmp/datasette.sock|http://localhost/my-datasette/
+
 The `ProxyPreserveHost On <https://httpd.apache.org/docs/2.4/mod/mod_proxy.html#proxypreservehost>`__ directive ensures that the original ``Host:`` header from the incoming request is passed through to Datasette. Datasette needs this to correctly assemble links to other pages using the :ref:`datasette_absolute_url` method.