diff --git a/docs/index.rst b/docs/index.rst
index aae7e675..bdd50d00 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -45,6 +45,7 @@ User documentation
     config
     running
     clients/index
+    troubleshooting
     authors
     licenses
     changes
diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
new file mode 100644
index 00000000..d29a5d2f
--- /dev/null
+++ b/docs/troubleshooting.rst
@@ -0,0 +1,14 @@
+.. _troubleshooting:
+
+***************
+Troubleshooting
+***************
+
+TODO:
+
+- --show-config
+- --list-deps
+- Issue tracker
+- Reporting bugs
+- Mailing list
+- IRC channel