Roundcube for Mobile Devices

We are well aware of the fact that Roundcube performs nicely on desktop browsers, it can be operated on tablets but when opening Roundcube from a smartphone, you’re out of luck.

Although creating a fully responsive theme which works on all screen sizes is on our roadmap and some volunteers are currently drafting it, we still looking at several months until the fully integrated solution will be available.

Luckily there are alternatives, thanks to the nature of free software! The most sophisticated amongst them is the Melanie2 Larry Mobile theme by Thomas Payen. It builds on top of the jQuery Mobile framework and completely replaces the default Roundcube skin with a fully optimized view when connecting with a mobile device. To do the automatic switch, the help of an additional Roundcube plugin is required. So here’s a quick guide how to install all the pieces in order to make your Roundcube mobile friendly:

1. Download the theme from GitHub

git clone skins/melanie2_larry_mobile

If you don’t have a git client available, simply download the Zip archive and unpack it into skins/melanie2_larry_mobile.

2. Install “mobile” and “jquery_mobile” plugins

php composer.phar require melanie2/mobile:dev-master

Since jquery_mobile is a dependency of the mobile plugin, this command will install both plugins right away.

ATTENTION: only the mobile plugin should be activated in Roundcube. Thus, when prompted “Do you want to activate the plugin jquery_mobile? [N|y]“, type “n” and later when the same prompt appears again for the mobile plugin, accept with “y“.

That’s already it.

With both the melanie2_larry_mobile skin and the mobile plugin installed, mobile devices will automatically see the mobile theme when accessing Roundcube. Kudos to Thomas, who added the missing piece to the Roundcube universe!


17 thoughts on “Roundcube for Mobile Devices

  1. oper says:

    1. download jquery_mobile”( and “mobile” ( in roundcube/plugins

    2. dowload composer.phar ( in roundcube/plugins

    3. running ‘php composer.phar require melanie2/mobile:dev-master’
    show following message, how to fix it please
    ./composer.json has been created
    Loading composer repositories with package information

    Installation failed, deleting ./composer.json.

    The “” file could not be downloaded: allow_url_fopen must be enabled in php.ini (https:// wrapper is disabled in the server configuration by allow_url_fopen=0
    failed to open stream: no suitable wrapper could be found)

    require [–dev] [–prefer-source] [–prefer-dist] [–no-progress] [–no-update] [–update-no-dev] [–update-with-dependencies] [–ignore-platform-reqs] [–sort-packages] [-o|–optimize-autoloader] [-a|–classmap-authoritative] [–] []…

    sorry , I don’t know how to install plug in Roundcube

  2. Peter Pan says:


    you need to set allow_url_fopen=1 in php.ini. after successful installation set it back to 0 (security).

  3. Wignu says:

    @oper Hi There, tried installing the plugins and received error:

    “The requested package melanie2/mobile could not be found in any version, there may be a typo in the package name.”

    Do you know if the package has been changed?

  4. Chris says:

    Hello I’m having issues installing this Roundcube Mobile skin on my VPS running CentOS 6.8 x86_64

    I had the server technicians install it following the instructions on your website.

    However it doesn’t seem to automatically detect my iPhone 6 as a mobile device and change the skin, it still shows the desktop skin?

    I tried manually changing the skin in the Roundcube Settings > User Interface and selected the “Mélanie2 Larry mobile” skin, but when I do this, it just reloads Roundcube without any CSS styling at all??

    This no CSS issue happens both on the mobile device as well as on the desktop.

    See screenshots below:

    Any idea why this might be happening?

    I would appreciate any help as I would really like to use this mobile skin for Roundcube!


  5. I installed the last Roundcube stable release 1.3, and this skin. Unfortunately, the version of Jquey used by 1.3 release is not compatible with jquery_mobile. See plugin issues.

  6. gflwrg says:

    This is hopelesss. Battled with it for hours with no result. All it does is mess up my desktop version by making it all mobile skin by default and not even displaying properly.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s