diff --git a/doc/source/irc.rst b/doc/source/irc.rst
index 2e8b2d816d..3e4a572498 100644
--- a/doc/source/irc.rst
+++ b/doc/source/irc.rst
@@ -320,3 +320,27 @@ Tips
    the new channel.
  * Don't leave the channel until everything is done, it's non-trivial to
    rejoin because you've set up a forward!
+
+Troubleshooting
+===============
+
+Bots may stop responding, common steps to troubleshoot the problem are:
+
+1. Check status of the bot, with:
+
+    service xxxbot status
+
+If bot is stopped, start it again. Restart the bot if you see it's running
+but not operating properly.
+
+2. On bot restart, it may show problems connecting to chat.freenode.net.
+If bot logs show it's stopped on connection, you can manually try with:
+
+    telnet chat.freenode.net 6667
+
+3. For bots on the eavesdrop server: if you don't have connection to that
+port, check entries on /etc/hosts for chat.freenode.net, until you find one
+server that is operative. Switch the entries on /etc/hosts to choose
+the right one, and restart the service with:
+
+    sudo service xxxbot restart