Updated: 10 November 2026 · Applies to: CWP (Control Web Panel, formerly CentOS Web Panel) 1.30.5 on AlmaLinux and Rocky Linux 8, 9 and 10, Roundcube 1.6.20 (from the CWP installer and update scripts; not installable in a test container)

To update Roundcube webmail on a CWP server, log in over SSH as root and run sh /scripts/mail_roundcube_update. The script backs up Roundcube and its database, installs the Roundcube version that your CWP release pins (1.6.20 in CWP 1.30.5), reinstalls the CWP Roundcube plugins and rolls back by itself if the new version does not load. To update CWP itself, run sh /scripts/update_cwp first.

1. Update CWP first

Each CWP release pins the Roundcube version its scripts install, so update the panel before Roundcube:

sh /scripts/update_cwp

In current CWP releases this script also repairs a few common problems before the update and, on servers whose panel still runs PHP 7, switches the panel to PHP 8.3 first.

2. Update Roundcube

sh /scripts/mail_roundcube_update

What the script does, according to the CWP 1.30.5 scripts:

  1. Reads the installed version from /usr/local/cwpsrv/var/services/roundcube/program/include/iniset.php. If it is already the same or newer, it stops and prints "Roundcube ... is up-to-date".
  2. Checks the panel PHP. Roundcube 1.6 needs PHP 7.3 or newer. On an older panel PHP the script stops with a message telling you to run sh /scripts/update_cwpphp83.
  3. Downloads the official Roundcube package and checks its SHA-256 checksum, so a broken download is never installed.
  4. Copies the current Roundcube folder and a dump of the roundcube database to /usr/local/src/roundcube_backup_VERSION_DATE, keeping the two newest backups.
  5. Runs Roundcube's own installto.sh, which updates the files, the configuration and the database schema, then restarts the panel web server.
  6. Checks the new version and the login page, and restores the backup if either fails.
  7. Reinstalls the CWP plugins (panel auto-login, calendar, tasks) when the version changed.

The details of each run are written to /var/log/cwp-rc-update.log:

tail -n 20 /var/log/cwp-rc-update.log

3. Check the installed version

grep "define('RCMAIL_VERSION'" /usr/local/cwpsrv/var/services/roundcube/program/include/iniset.php

Inside webmail, Settings, About shows the version too.

Old instructions: the Larry skin

Older guides, including the earlier version of this article, change the skin from larry to elastic with a sed command. That is no longer needed: according to Roundcube, the Larry and Classic skins are not part of the release packages from Roundcube 1.6, and the current CWP installer already sets $config['skin'] = 'elastic';. If an old server still has larry in its configuration and webmail looks broken after the update, check the file:

grep -n "skin" /usr/local/cwpsrv/var/services/roundcube/config/config.inc.php

and set the line to $config['skin'] = 'elastic';.

Change the webmail language (for example Norwegian)

Each user can pick a language in Roundcube under Settings, Preferences, User Interface. To set a default for everyone, add a language line to /usr/local/cwpsrv/var/services/roundcube/config/config.inc.php. Roundcube's default is null, which means it detects the browser language. For Norwegian Bokmål use nb_NO, for Nynorsk nn_NO:

$config['language'] = 'nb_NO';

Which operating systems does CWP support?

According to the CWP installation instructions, AlmaLinux 8, 9 and 10 are the recommended choice; Rocky Linux 8, 9 and 10, CentOS Stream 8 and 9 and Oracle Linux 7 to 9 are also listed. The current installer is one script that detects the version:

cd /usr/local/src
curl -Lo cwp-latest http://centos-webpanel.com/cwp-latest
sh cwp-latest

The CWP page still lists CentOS 7, but CentOS 7 is end of life and gets no security updates, and CWP notes that its mirrors are closed. Plan a move to AlmaLinux instead; see How to Install CentOS Web Panel (CWP) on AlmaLinux and Rocky Linux 9.

Related articles

Need help with a CWP server? Our server management team can update or migrate it for you.

Official documentation: CWP installation instructions, CWP wiki, Roundcube releases.

Related services

Managed Webmin VPS

root access with updates, security and monitoring handled, from $22 a month.

KVM VPS hosting

NVMe SSD and full root access, with Free Basic Managed Support.

Was this answer helpful?

Still stuck? Open a ticket