mailcow-dockerized-docs/docs/debug.md

When a problem occurs, then always for a reason! What you want to do in such a case is:

1. Read your logs; follow them to see what the reason for your problem is.
2. Follow the leads given to you in your logfiles and start investigating.
3. Restart the troubled service or the whole stack to see if the problem persists.
4. Read the documentation of the troubled service and search it's bugtracker for your problem.
5. Search our [issues](https://github.com/mailcow/mailcow-dockerized/issues) and [forum](https://forum.mailcow.email/) for topics related to your problem.
6. [Create an issue](https://github.com/mailcow/mailcow-dockerized/issues) over at our GitHub repository if you think your problem might be a bug or a missing feature you badly need. But please make sure, that you include **all the logs** and a full description to your problem.
7. If you need help with a problem on a configuration or a setup, or got a question please head over to our [forum](https://forum.mailcow.email/) and open a thread.
8. Connect to IRC ([chat.freenode.net](https://webchat.freenode.net/)) and join our IRC channel [#mailcow](irc://chat.freenode.net:6667/mailcow).
Formatting 2017-05-06 19:10:37 +02:00			`When a problem occurs, then always for a reason! What you want to do in such a case is:`
Restructured Troubleshooting 2017-05-06 18:24:40 +02:00
			`1. Read your logs; follow them to see what the reason for your problem is.`
			`2. Follow the leads given to you in your logfiles and start investigating.`
Spelling 2017-05-09 17:23:05 +02:00			`3. Restart the troubled service or the whole stack to see if the problem persists.`
Restructured Troubleshooting 2017-05-06 18:24:40 +02:00			`4. Read the documentation of the troubled service and search it's bugtracker for your problem.`
			`5. Search our [issues](https://github.com/mailcow/mailcow-dockerized/issues) and [forum](https://forum.mailcow.email/) for topics related to your problem.`
			`6. [Create an issue](https://github.com/mailcow/mailcow-dockerized/issues) over at our GitHub repository if you think your problem might be a bug or a missing feature you badly need. But please make sure, that you include all the logs and a full description to your problem.`
			`7. If you need help with a problem on a configuration or a setup, or got a question please head over to our [forum](https://forum.mailcow.email/) and open a thread.`
Added IRC 2017-05-06 18:40:18 +02:00			`8. Connect to IRC ([chat.freenode.net](https://webchat.freenode.net/)) and join our IRC channel [#mailcow](irc://chat.freenode.net:6667/mailcow).`