diff --git a/docs/reference/troubleshooting.md b/docs/reference/troubleshooting.md
index 8b89799a..9b1c3767 100644
--- a/docs/reference/troubleshooting.md
+++ b/docs/reference/troubleshooting.md
@@ -19,3 +19,24 @@ ssh-add ~/.ssh/id_rsa
 
 Where `id_rsa` is the name of your private key file you use for connecting
 to GitHub.
+
+## Cannot connect to the Docker daemon
+
+Solution 1: start the daemon manually with `systemctl start docker`,
+if the daemon was already running, add your user to the `docker` group, then
+log out and in for the change to be effective.
+
+Solution 2: use rootless docker, the way to setup this depends on your
+distribution, in some cases, it's a matter of installing a variant package
+like `docker-rootless`.
+
+## Docker daemon errors initializing graphdriver
+
+Solution: The most likely reason is that you are using a filesystem like `zfs`
+or `btrfs` which requires a special storage driver, click
+[link](https://docs.docker.com/engine/storage/drivers/select-storage-driver/)
+for more information
+
+## Error processing a compose file
+
+Solution: make sure your docker compose is up to date