📚 Add troubleshooting documentation

lorisleiva · lorisleiva · commit fbd0e5d6418a · 2018-03-10T14:24:34.000+01:00
diff --git a/docs/README.md b/docs/README.md
@@ -19,6 +19,6 @@
 * [Available tasks](all-tasks.md)
 * [Available recipes](all-recipes.md)
 * [Custom tasks and hooks](custom-tasks.md)
-* [Troubleshooting](troubleshooting.md) (TODO)
+* [Troubleshooting](troubleshooting.md)
 
 For more advanced documentation, please refer to the [Deployer documentation](https://deployer.org/docs).
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
@@ -1,3 +1,18 @@
-# Troubleshooting
+# 🚨 Troubleshooting
 
-TODO
+## Unable to setup correct permissions for writable dirs.
+
+**Problem:**
+
+```bash
+[RuntimeException]
+Cant't set writable dirs with ACL.
+```
+
+**Solution:**
+
+Since Deployer uses `acl` by default to set up permissions for writable directories, this is likely that your server does not have it installed yet. Running the following command (on linux) and restarting deployment should fix that for you.
+
+```bash
+sudo apt-get install acl
+```
