Difference between revisions of "Roundcube"

Revision as of 15:53, 17 February 2025

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 `index.php`: the actual root page `.htaccess` → `../.htaccess` → `/etc/roundcube/htaccess` `skins/` ⇐ `public_html/skins/` `plugins/` ⇐ `public_html/plugins/` `index.php` ⇐ `/usr/share/roundcube/index.php` `.htaccess` → `/etc/roundcube/htaccess`

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

@@ Line 31: / Line 31: @@
 It also contains a few web-app-related things:
 * <code>public_html/</code>: the web server should point at this folder
-* <code>skins/</code> &larr; <code>public_html/skins/</code>
+** <code>index.php</code>: the actual root page
-* <code>plugins/</code> &larr; <code>public_html/plugins/</code>
+** <code>.htaccess</code> &rarr; <code>../.htaccess</code>
-* <code>index.php</code> &larr; <code>/usr/share/roundcube/index.php</code>
+*** &rarr; <code>/etc/roundcube/htaccess</code>
-* <code>.htaccess</code> &larr; <code>/etc/roundcube/htaccess</code>
+* <code>skins/</code> ''&lArr; <code>public_html/skins/</code>''
+* <code>plugins/</code> ''&lArr; <code>public_html/plugins/</code>''
+* <code>index.php</code> ''&lArr; <code>/usr/share/roundcube/index.php</code>''
+* <code>.htaccess</code> &rarr; <code>/etc/roundcube/htaccess</code>
 |}
 When installed this way, however, RC is ''not'' configured to play nicely with a virtual domain. It seems to expect to run as <code>www-data</code>. Tentatively, the remedy is just to change ownership of everything it touches (including log folders), but I'm still working on this. &mdash;''[[User:Woozle|Woozle]] ([[User talk:Woozle|talk]]) 15:02, 17 February 2025 (UTC)''