diff --git a/manuscript/reference/troubleshooting.md b/manuscript/reference/troubleshooting.md
new file mode 100644
index 0000000..8f932e0
--- /dev/null
+++ b/manuscript/reference/troubleshooting.md
@@ -0,0 +1,17 @@
+# Troubleshooting
+
+Having difficulty with a recipe? Here are some tips..
+
+## Why is my stack not launching?
+
+Run ```docker stack ps <stack name> --no-trunc``` for more details on why individual containers failed to launching
+
+## Attaching to running container
+
+Need to debug **why** your oauth2_proxy container can't talk to its upstream app? Start by identifying which node the proxy container is running on, using ```docker ps <stack name>```.
+
+SSH to the host node, and attach to the container using ```docker exec -it <continer id> /bin/bash``` (_substitute ```/bin/ash``` for ```/bin/bash```, in the case of an Alpine container_), and then try to telnet to your upstream host.
+
+## Watching logs of container
+
+Need to see what a particular container is doing? Run ```docker service logs -f <stack name>_<container name>``` to watch a particular service. As the service dies and is recreated, the logs will continue to be displayed.
diff --git a/mkdocs.yml b/mkdocs.yml
index 5f0ee67..969532c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -59,6 +59,7 @@ pages:
       - Networks: reference/networks.md
       - git-docker : reference/git-docker.md
       - OpenVPN : reference/openvpn.md
+      - Troubleshooting: reference/troubleshooting.md      
     - Support: support.md
 
 theme: