Troubleshooting Roundcube 101
I often idle in the #roundcube channel on Freenode and I’ve come to realize that time after time, I offer exactly the same help to numerous users. There are a few basic tasks that you should make sure you’ve completed before asking in the channel:
1. Read The Config Files!!!
RC’s configuration files are well documented and revisiting that potent, inline documentation can often answer your questions.
2. Enable Logging
If you’re experiencing undesired behavior, 9 times out of 10, the problem is the way you’ve configured RC. There is no way to identify yourself as the problem, without knowing exactly what it is that RC is doing behind the scenes. For that, you need to enable logging.
Just think… If the problem is in the logs, you won’t have to look stupid when you realize you made a typo on the mail server hostname. Less public ridicule is always a good thing!
Make sure your log directory is able to be written to by the web server!
3. READ THE LOGS
The logging is written in plain English. If you don’t know English, you’re probably not reading this page.
4. Google The Error
Now that you have thoroughly read through the log file and see errors indicating what may be wrong with your configuration, you have everything you need to make important inferences. If these inferences aren’t enough to guide you into a working configuration, it’s time for you to Google the error message. Chances are you’ll find somebody who has had the same issue and has since fixed it. If you’re lucky enough, this kind fellow may have posted the solution to your very problem!
5. Still Need Help?
If you’re unfortunate enough to come to this section having completed the previous sections thoroughly, you’ve either missed something (which happens), or you’ve got a problem that people in the channel will be interested to help you solve! All that’s left is for you to present the problem in a well-thought-out form. You should also make sure to mention the steps you’ve performed to try to fix your issue.
Now that you’ve asked your question, you have only one thing left to do — WAIT. Nobody in the channel is paid to support you, so if they’re busy, they may be disregarding the channel. You get what you pay for.
