Roundcube

About

Roundcube (RC) is a webmail client that runs under the LAMP stack.

Files

When installed via apt, this is where Roundcube's files end up:

path	description
/etc/roundcube	global configuration stuff: defaults.inc.php: must be present; should not be edited config.inc.php: must be present, and should be edited to contain local settings main.inc.php: old name for config.inc.php RC will load this if config.inc.php is not found should not be present in new installations debian-db.php: database credentials for RC installs in Debian-based systems
/usr/share/roundcube	application code
/var/lib/roundcube	installation image -- about half of the top folders here are just links: config → /etc/roundcube logs → ../../log/roundcube (/var/log/roundcube) program → /usr/share/roundcube/program SQL → /usr/share/roundcube/SQL It also contains a few web-app-related things: public_html: the web server should point at this folder skins ← public_html/skins plugins ← public_html/plugins

When installed this way, however, RC is not configured to play nicely with a virtual domain. It seems to expect to run as www-data. Tentatively, the remedy is just to change ownership of everything it touches (including log folders), but I'm still working on this. —Woozle (talk) 15:02, 17 February 2025 (UTC)

Tech Notes

The MariaDB/MySQL password must not contain the & character, because the DSN parser treats it as syntactically significant. There does not seem to be any way of escaping it, either. The critical piece of code is in /usr/share/roundcube/program/lib/Roundcube/rcube_db.php, line 1336:

if (strpos($dsn, '&') !== false) {
    $opts = explode('&', $dsn);
}

Pages

• /archive: obsolete stuff

Links

Reference

• roundcube.net - official
• Wikipedia