Hello,
I manage a Mac OS X Leopard Server for a small business. While I suspect the next release of Mac OS X Server, Snow Leopard, may include a more user friendly webmail application I wasn't very excited about waiting another year for it and SquirrelMail was getting on my users' nerves.
I looked around the internet for webmail alternatives and stumbled upon Roundcube. I gave Roundcube a shot and have been really enjoying it so far, even in it's .2 incarnation. While installation of Roundcube is fairly strait forward I did need to consult a few different websites and perform some trial and error on the settings file.
Because I haven't seen any other Leopard Server specific tutorials on the internet for installing Roundcube I decided to make one myself. I wrote it primarily to have a reminder of what steps I took in case I need to reinstall on a fresh machine at some point in the future. I wanted to make it available to anyone else who has a Leopard Server in case it might be useful.
You can download the .pdf here:
Guide to Installing Roundcube Webmail on Mac OS X Leopard ServerThe guide walks you through, downloading Roundcube, installing Roundcube, and running the necessary services (MySQL and Web). The guide assumes you're running Mac OS X Leopard Server and its Mail service and the recommended settings are tailored as such.
If you have any comments on the guide please PM me.
take care,
berylium
UPDATE 2009.10.15I finally updated my .2 beta installation of Roundcube to .3 stable. All the instructions in my guide still hold true. The only changes I would make (that weren't worth updating the guide) include:
- In step 3, those 'chown' commands may need to be preceded with 'sudo'. e.g. "sudo chown -R www:www temp"
- My download of .3-stable did not include the image file rcube_watermark.png. Since this image is shown in the preview area any time a message is not selected I was seeing a lot of blank squares with question marks since the web browser couldn't find the file. To fix I just copied rcube_watermark.png out of roundcubemail-0.2-beta/skins/default/images and pasted it in the same folder in roundcubemail-0.3-stable.
So if you're installing Roundcube for the first time in Leopard Server (10.5) then the linked guide with the above changes should work for you. If you're updating Roundcube just be sure to keep your old roundcube folder around so you can update the new main.inc.php and db.inc.php files with the settings you used in the old files.
As for people who have questions setting up Roundcube in Leopard Server, I wish I could be of more help to you but the guide I made is pretty much the full extent of my Roundcube knowledge. So if you're running into problems after your installation my only suggestion is to search the roundcube forums and run a web search on your error, maybe someone else out there has documented a fix.
-berylium
UPDATE 2009.10.31I updated from .3 stable to .3.1 and, again, there were no issues. If you already have Roundcube .2 or .3 installed these are the steps you would follow to upgrade:
1. Step 1 from the linked guide
2. Step 3 from the linked guide, but be sure to run both chown commands as root with sudo. e.g. "sudo chown -R www:www temp"
3. Step 7(a) and 7(b) from the linked guide
At this point your websites folder on your server will have the roundcube installation you've been using (roundcubemail-0.2-beta, roundcubemail-0.3-stable, etc.), the .3.1 roundcube installation folder (roundcubemail-0.3.1), and the folder symbolic link created in step 2 of the linked guide (roundcubemail).
4. Using a plain text editor open the db.inc.php file in the config folder of your old Roundcube installtion and the same file in the .3.1 config folder. Update db.inc.php from the .3.1 installation with the database info you entered into db.inc.php in your old installation, it's line 21 in the file. Close both files saving the changes on the .3.1 db.inc.php.
5. Open the old and the new main.inc.php files. Scroll through the old file and make sure any changes to settings you made in the old file are inserted into the new file. This way, apart from the new features, your old and new installations will be identical.
6. Step 2 from the linked guide but updating the folder name for the .3.1 installation. "sudo ln -s /websites/roundcubemail-0.3.1 /websites/roundcubemail"
Now the symbolic link used by the web service to send requests to the old Roundcube installation will be sent to the .3.1 installation. Make sure and go to your site to make sure everything works but you should be all done.
P.S. If you broke something and your site isn't working properly you can re-link the symbolic link back to your old installation while you troubelshoot the problem so your users aren't left in the cold. This is why we didn't delete the old installation folder(s). For instance, if I was using .3 and I upgraded to .3.1 but broke something in the process I would: open the Terminal, 'cd' to my websites folder, and run "sudo ln -s /websites/roundcubemail-0.3-stable /websites/roundcubemail" Now visitors to my site would be linked to the working .3 installation while I fixed .3.1.
take care,
berylium