From 770e82f21bc9c69168c38e9e6d179ec518344069 Mon Sep 17 00:00:00 2001
From: Tomasz Borychowski <tborychowski@gmail.com>
Date: Mon, 14 Dec 2020 15:25:07 +0000
Subject: [PATCH] docker troubleshooting

---
 README.md                 |  6 ++---
 docker/setup.md           |  1 +
 docker/troubleshooting.md | 47 +++++++++++++++++++++++++++++++++++++++
 docker/usage.md           |  1 +
 4 files changed, 52 insertions(+), 3 deletions(-)
 create mode 100644 docker/setup.md
 create mode 100644 docker/troubleshooting.md
 create mode 100644 docker/usage.md

diff --git a/README.md b/README.md
index 80604a2..caa75d6 100644
--- a/README.md
+++ b/README.md
@@ -18,9 +18,9 @@ So, without further ado, here's the current list:
 
 
 # General Information
-- How to setup docker & docker-compose?
-- How to use docker-compose
-- Troubleshooting
+- [How to setup docker & docker-compose?](docker/setup.md)
+- [How to use docker-compose](docker/usage.md)
+- [Troubleshooting](docker/troubleshooting.md)
 
 # Other self-hosted sources
 - [awesome-selfhosted](https://github.com/awesome-selfhosted/awesome-selfhosted)
diff --git a/docker/setup.md b/docker/setup.md
new file mode 100644
index 0000000..1c598d8
--- /dev/null
+++ b/docker/setup.md
@@ -0,0 +1 @@
+# Docker Setup
diff --git a/docker/troubleshooting.md b/docker/troubleshooting.md
new file mode 100644
index 0000000..a15cc6b
--- /dev/null
+++ b/docker/troubleshooting.md
@@ -0,0 +1,47 @@
+# Docker Troubleshooting
+
+
+### ERROR: Version in "./docker-compose.yml" is unsupported.
+```sh
+sudo apt-get remove docker-compose
+sudo curl -L "https://github.com/docker/compose/releases/download/1.23.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+sudo chmod +x /usr/local/bin/docker-compose
+sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
+```
+
+
+### ERROR: Couldn't connect to Docker daemon at http+docker://localhost - is it running?
+```sh
+sudo reboot
+```
+
+
+### ERROR: Permission denied while trying to connect to the Docker daemon
+```sh
+sudo usermod -a -G docker $USER
+```
+
+
+### ERROR: mountpoint for devices not found
+e.g.
+```
+OCI runtime create failed: container_linux.go:349: starting container process caused "process_linux.go:297: applying cgroup configuration for process caused \"mountpoint for devices not found\"": unknown
+```
+
+#### Follow These Steps:
+1. edit grub
+  ```sh
+  sudo nano /etc/default/grub
+  ```
+2. change GRUB_CMDLINE_LINUX value to the below:
+  ```
+  GRUB_CMDLINE_LINUX="systemd.unified_cgroup_hierarchy=0"
+  ```
+3. then run:
+  ```sh
+  grub2-mkconfig
+  ```
+4. then:
+  ```sh
+  sudo reboot
+  ```
diff --git a/docker/usage.md b/docker/usage.md
new file mode 100644
index 0000000..2afe42d
--- /dev/null
+++ b/docker/usage.md
@@ -0,0 +1 @@
+# Docker Usage