diff --git a/_docs/configuration.md b/_docs/configuration.md
index 66cf9db..eb61ead 100644
--- a/_docs/configuration.md
+++ b/_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