Configuring the run directory

_docs/configuration.md

@@ -80,6 +80,17 @@ SOME_SECRET=<%= `bw get notes 123123123-1232-4224-222f-234234234234 --session #{
 
 Then everyone deploying the app can run `kamal envify` and kamal will generate `.env`
 
+## Configuring the run directory
+
+Kamal needs to create files on the host for locking and audit logs.
+
+By default these will be created in the `kamal` subdirectory of the default SSH directory.
+
+This can be changed with
+
+```yaml
+run_directory: /var/run/kamal
+```
 
 ## Using another registry than Docker Hub
 
@@ -208,7 +219,7 @@ volumes:
 
 Directories act in a similar way to volumes except it will create a corresponding directory on the host before mounting the volume:
 
-e.g. 
+e.g.
 
 ```yaml
 service: kamal-demo