Roundcube for macOS Server

What’s new in version 1.3.6?
Compatibility
  • Mac OS X Server 10.8.3 w/ Server 2.x – through -> 10.13.x High Sierra w/ Server.app 5.6.x
Why we made this installer

Mac OS X Server administrators usually wear many hats (entrepreneur, designer, etc.). We choose the Mac expecting it to have a nice GUI interface and all our basic needs to be met out of the box.
Apple used to provide webmail services in earlier versions of OS X Server (10.7 and earlier). For reasons unknown, webmail was dropped in 10.8 leaving it up to administrators to roll their own solution.

An OS X Server administrator with a Unix background could jump through all the hoops in a couple of hours – but lets face it, most OS X Server administrators would be stuck facing a day or more of tutorials, articles and frustration to get webmail working on their server.

As consultants specializing in mail services for OS X Server, we found ourselves repeating the same steps over and over with each new server installation. So we decided to apply our rule of thumb: if a repeatable process takes more than 30 minutes – document, automate and share.

What does the installer do?

Our installer for Roundcube for OS X Server installs Roundcube Webmail as a simple WebApp available to any website configured inside Server.app. When the WebApp is enabled (by default, its enabled for all sites), you can access webmail by adding /mail /webmail or /roundcube to your website URL.

Please browse our FAQs for answers to most questions.

See current changelog for a complete list of fixes and additions.
Please read our FAQs as well.

The topicdesk Roundcube installer is a free download.

 

 

212 replies
« Older CommentsNewer Comments »
  1. David Muszynski
    David Muszynski says:

    The install was a breeze, but I’ve got a config question. I’m running 10.10.2 and Server 4.0.3.
    I’m hosting multiple domains for web and e-mail. When I log into roundcube it automatically assigns one of the domains that would basically never be used. How do we offer a list of domains to sign in under during login?

    I’m hosting technospider.com, floridapets.org, brevardac.net, huntingthehaunting.com, and pearlharbor911attacks.com
    SSL is turned on only for starfleet.technospider.com, so I use that as my webmail portal. When someone signs in they are automatically set up with the e-mail of (user)@pearlharbor911attacks.com

    Any help is appreciated.

  2. Jeff Johnson
    Jeff Johnson says:

    @David Muszynski

    We set defaults to assign users to your primary domain (mydomain in postfix config).
    This fits 9 out of 10 installations.

    The easiest option is to have users login with their full email address (not just shortname) – it then sets the domain based on your login.

    You’ll find plenty of config options and even some plugins to improve the setup for your environment.
    I suggest you checkout the roundcube documentation ([url]”http://roundcube.net/support/”[/url]) and the plugin repository ([url]”http://trac.roundcube.net/wiki/Plugin_Repository”[/url])

    Our installation is standard- you just need to know where to find it:
    /usr/local/topicdesk/roundcube/WebApp/

    Jeff

  3. Jeff Johnson
    Jeff Johnson says:

    @ Ricardo

    I’m not sure about signatures – check the roundcube documentation ([url]”http://roundcube.net/support/”[/url]) and the plugin repository ([url]”http://trac.roundcube.net/wiki/Plugin_Repository”[/url])

  4. David Muszynski
    David Muszynski says:

    @ Jeff –
    “The easiest option is to have users login with their full email address (not just shortname) – it then sets the domain based on your login.”

    I tried this first. It gave me an error ‘Login Failed’ with some users, others it worked for. It’s kind of strange.

    And I did find the roundcube docs, but I guess I’m just not smart enough to parse them as I saw descriptions of what I wanted to achieve, but not sure how to implement it. And I don’t want to experiment and possibly hose my installation. I guess I’ll have to set up a test server and play around.

    [quote]Configuring for Virtual Users

    Virtual users are useful for hosting providers where a single mailserver is providing email for a number of different domains. The goal is that the user logs in to roundcube with their email login/password, and roundcube knows where to lookup their complete email address. Two options are support, SQL lookups or a sendmail style virtuser file.

    Important: Since version 0.4 this requires enabling the appropriate plugins which are virtuser_file and virtuser_query.

    In order to test if virtuser is configured correctly, log in to roundcube with a user that does not exist yet. Compose a message, if you see the From address as user@correct_domain, then it worked. If you see user@localhost, something is wrong. To reset and try again, delete that user from the roundcube users table (all related records will be removed using foreign keys cascading).

    1) virtuser_file

    $rcmail_config[‘virtuser_file’] = ‘/etc/mail/virtuser’;
    This assumes that the file /etc/mail/virtuser contains information about your virtual users in the following format:

    user@domain login1
    user@domain login2
    2) virtuser_query (SQL)

    $rcmail_config[‘virtuser_query’] = “SELECT email_address FROM database.table WHERE login = ‘%u'”;
    If you are using postfix and/or some kind of hosting panel, chances are your email accounts are already stored in a SQL table. If that is the case, you want to lookup the emails with a virtuser_query. Virtuser_query plugin also allows to set all identity fields using the query. The parts of the example query:

    // email_address – the first column returned by the query must be the complete email address
    // database – name of the database where your table is located, the roundcube db user must have read access
    // table – name of the table where your email addresses are stored
    // login – name of the field that contains the username that is used to log in to roundcube (and send/receive email)[/quote]

    That looks promising, but does the first way mean I have to manually update the virtuser file every time I add a user? And how do I manage the roundcube users table?

    The second way would require me to get some major help from a SQL guru since all I know how to do is set up tables via phpmyadmin for use with Drupal.

  5. Jeff Johnson
    Jeff Johnson says:

    @ David Muszynski

    Hi David

    You should consider hiring someone to set this up for you.
    Its not difficult – but paying someone for an hour could save you a day (or more) of setup and trial/error.

    We can assist – or you should be able to find plenty of other consultants available to help with roundcube config.
    http://topicdesk.com/consultancy

    Jeff

  6. Bertrand POURCEL
    Bertrand POURCEL says:

    Hi,

    I’ve got problem with vacation plugin.
    It doesn’t work even if it’s correctly setup for the user. (with additional mail adress, etc…)
    Filters set are activated, and filter is activated too
    I see nothing in the logfiles to determine where the problem is…

    Thanks
    Bertrand.

    Yosemite Server 4.03 – TopicDesk Roundcube 1.0.3

  7. Jeff Johnson
    Jeff Johnson says:

    @ Bertrand POURCEL

    Try turning -OFF- “Digest-MD5” authentication in Server.app/Mail/CustomAuthentication

    The plugin config file has a logging option.
    The config file is here:
    /usr/local/topicdesk/roundcube/WebApp/plugins/managesieve/config.inc.php

    You will find the option to enable sieve logging
    // Enables debugging of conversation with sieve server. Logs it into /sieve
    $rcmail_config[‘managesieve_debug’] = false;

    You will find general logging options in the config.inc.php and defauilts.inc.php files located here:
    /usr/local/topicdesk/roundcube/WebApp/config/

    The log files are here by default
    /usr/local/topicdesk/roundcube/WebApp/logs/

  8. Julian
    Julian says:

    Hi Jeff

    Same issue as Bertrand POURCEL on 2 Servers

    Mavericks Server with 1.0.3 RC
    Digest MD5 is switched off
    The Filters work fine other than the vacation (Reply with message) drop down

    errors log
    r-2015 19:01:45 +0100]: IMAP Error: Login failed for j.lopez from 192.168.11.110. Temporary authentication failure. [osxserver.my_domain.co.uk:2015-04-02 19:01:45] in /usr/local/topicdesk/roundcube/1.0.3a/program/lib/Roundcube/rcube_imap.php on line 184 (GET /mail/?_task=mail&_refresh=1&_mbox=Sent+Messages&_page=1&_action=list&_remote=1&_unlock=loading1427997670906&_=1427997626275)
    [02-Apr-2015 19:25:03 +0100]: IMAP Error: Login failed for j.lopez from 192.168.11.110. Temporary authentication failure. [osxserver.my_domain.co.uk:2015-04-02 19:25:03] in /usr/local/topicdesk/roundcube/1.0.3a/program/lib/Roundcube/rcube_imap.php on line 184 (POST /mail/?_task=mail&_action=refresh?_task=&_action=)
    [02-Apr-2015 19:29:03 +0100]: IMAP Error: Login failed for j.lopez from 192.168.11.110. AUTHENTICATE CRAM-MD5: A0001 NO [UNAVAILABLE] Internal error occurred. Refer to server log for more information. in /usr/local/topicdesk/roundcube/1.0.3a/program/lib/Roundcube/rcube_imap.php on line 184 (POST /mail/?_task=mail&_action=refresh?_task=&_action=)

    the config.inc.php file contains
    // IMAP config
    // To use SSL/TLS connection, enter hostname with prefix ssl:// or tls://
    $config[‘default_host’] = ‘localhost’;
    $config[‘default_port’] = 143;
    $config[‘imap_auth_type’] = CRAM_MD5;

    // these are set automatically during installation
    $config[‘db_dsnw’] = ‘sqlite:////usr/local/topicdesk/roundcube/db/sqlite.db?mode=0646’;
    $config[‘plugins’] = array(‘managesieve’, ‘carddav’);
    $rcmail_config[‘support_url’] = “http://osxserver.my_domain.co.uk/”;
    $rcmail_config[‘des_key’] = “WV%s2#X4^79]4F?aj`6Ek=]J”;
    $rcmail_config[‘smtp_helo_host’] = “osxserver.my_domain.co.uk”;
    $config[‘smtp_server’] = ‘localhost’;
    $rcmail_config[‘mail_domain’] = “my_domain.co.uk”;

  9. Yoni
    Yoni says:

    I just deployed your installer in OS X 10.10 and upgraded it to Roundcube 1.1.1 stable. Your package works pretty well for the most part. I did notice few things that were out of place in the configuration (at least in your latest package which ships with Roundcube 1.0.3).

    1- $rcmailconfig in ./config/config.inc.php needs to be replaced with $config. ($rcmailconfig has been deprecated since 0.9.5)
    2-Default folders were not properly named or configured to be created by default.
    3- ‘Deleted Messages’ and ‘Sent Messages’ can be left there but the default for OS X is ‘Sent’ and ‘Trash’. Both of them should be defined in the default folders.
    4- Set default folders to be created on user first login. It will prevent issues for those who use webmail even before connecting the Mail client application to their account. Note that Apple Mail creates these folders a they are used. So, save the trouble, time and set it accordingly.
    5- logs and temp folder permissions must be adjusted to allow the webserver to write to those folders _www user/group
    6- Make sure to enable mod_digest, mod_rewrite and mod_expires in apache.

    With those minor changes, your package was indeed very well put together for simplicity and we will look at MyRoundcube Project https://myroundcube.com to include this information taking as base your package.

    Last but not least, it would be good to also recommend users to add a sqlite3 management tool. It helps with management, although this is obviously out of the scope of your package.

    Great work guys!

  10. Ian Baker
    Ian Baker says:

    Installed the TopicDesk RoundCube installer, then upgraded to RoundCube 1.1. Both before and after the upgrade, we’ve been having issues with the CardDav plugin. Folks are getting error popups when they attempt to add contacts to their server based address books. How can I debug the issue – is there a way to turn on additional diagnostics for a plugin?

    TIA

  11. KPrinz
    KPrinz says:

    After the 10.10.3/Server 4.1 Update roundcube is gone from Apache.
    Is there a simpler step (restore some config) to reneable it, instead of just reinstalling?

  12. fonny
    fonny says:

    @KPrinz
    [quote]After the 10.10.3/Server 4.1 Update roundcube is gone from Apache.[/quote]
    Had the same problem. This solved it for me.
    Open Server v4.1
    Started Websites
    At the Websites edit (yourmailserver.com (SSL)
    Edit Advanced Settings…
    Enabled topicdesk-Roundcube

  13. Dave Pearce
    Dave Pearce says:

    Hey!

    So I stumbled across this download package when setting up Yosemite with Server app 4.1

    Everything installed fine, I can access RoundCube through Safari at locahost. I can also access RoundCube across the internet at domain.tld/mail Great!!!

    The thing is, I’ve set up a subdomain of webmail.domain.tld and I’ve ticked the option to enable Roubdcube as a web app, but for some reason, when I try accessing the subdomain I am shown the default page for a new website rather than RoundCube login.

    Any ideas?

  14. Dave Pearce
    Dave Pearce says:

    Hey!

    So I stumbled across this download package when setting up Yosemite with Server app 4.1

    Everything installed fine, I can access RoundCube through Safari at locahost. I can also access RoundCube across the internet at domain.tld/mail Great!!!

    The thing is, I’ve set up a subdomain of webmail.domain.tld and I’ve ticked the option to enable Roubdcube as a web app, but for some reason, when I try accessing the subdomain I am shown the default page for a new website rather than RoundCube login.

    Any ideas?

  15. Alessandro
    Alessandro says:

    As Conrad wrote in here, I found that adding the %u and %p to authenticate the currently-logged in user for SMTP defaults.inc.php config did solve all my SMTP issues.

  16. julian
    julian says:

    Hi

    Using round cube 1.0.3 and unable to get the Filter action ‘Reply with message’ to work.
    Can anybody help or advise?

    thanks

  17. Alfista
    Alfista says:

    Hi, can anybody help me, how can I update the Roundcube installed with Topickdesk to the latest version?
    Thanks.

  18. Stefano Paglino
    Stefano Paglino says:

    Hi,
    this work for me.

    Download the latest version of Roundcube, decompress it.
    Proceed only if your roundcube installation already works (don’t use this to fix an installation) and be sure to backup your system.

    Adjust your paths as necessary

    cd ~/Downloads/roundcubemail-1.1.2/bin
    sudo ./installto.sh /usr/local/topicdesk/roundcube/WebApp
    * enter your password if requested
    * hit y to continue
    * hit y to fix local configuration

    Thats it.. You are running the latest version.

  19. Eckes
    Eckes says:

    Hi there,
    will there be an updated version für the new roundcube-version soon?
    Thanks, Thomas

  20. Stefano Paglino
    Stefano Paglino says:

    You need only a working installation of roundcube.
    I test it from 1.0.3 and 1.1.1

« Older CommentsNewer Comments »

Comments are closed.