Comprehensive Guide to Installing iRedMail on Linux

1. Installation Path

• Main directory: /opt/www/roundcubemail/
• This is a symbolic link to the actual version (e.g., roundcubemail-1.6.x).

2. Configuration Files

• Main custom configuration: /opt/www/roundcubemail/config/config.inc.php
• Important: Never edit defaults.inc.php directly. Copy settings into config.inc.php and override them there.
• For iRedMail Easy: use /opt/iredmail/custom/roundcube/custom.inc.php (create if missing).
• Plugin-specific configs: /opt/iredmail/custom/roundcube/config_pluginname.inc.php

3. Logs

Roundcube logs are usually integrated with Postfix logs:

• /var/log/maillog
• /var/log/mail.log

4. Checking Installation Paths

find /opt -name "roundcubemail" -type d
ls -l /opt/www/roundcubemail/config/

5. Key Configuration Categories

5.1 IMAP & SMTP Connectivity

$config['imap_host'] = 'localhost:993'; // SSL
$config['smtp_host'] = 'localhost:587'; // TLS

5.2 Database

$config['db_dsnw'] = 'mysql://roundcube:password@localhost/roundcubemail';

5.3 Security & Appearance

• $config['des_key']: encryption key
• $config['skin_logo']: custom logo
• $config['force_https'] = true;
• $config['enable_spellcheck'] = true;

5.4 Plugins

$config['plugins'] = ['password', 'managesieve', 'zipdownload'];

iRedMail enables password and managesieve by default.

5.5 User Behavior

$config['preview_pane'] = true;
$config['language'] = 'fa_IR'; // Persian

5.6 Logging & Debugging

$config['debug_level'] = 1;
$config['imap_debug'] = true;
$config['smtp_debug'] = true;
$config['sql_debug'] = true;

5.7 Other Features

• CardDAV/CalDAV support
• Spam filters, signatures, auto-reply

6. Important Notes

• After editing config.inc.php, restart the web server (Nginx/Apache) if necessary.
• For debugging, set debug_level = 4 and enable SQL/IMAP/SMTP debug options.
• User-level settings (language, theme, signature) are managed inside Roundcube UI under Settings → Preferences, Identities, Folders.

Conclusion

Roundcube is a flexible and feature-rich webmail client integrated with iRedMail. Administrators should manage custom settings via config.inc.php or custom files, avoid editing defaults directly, and configure IMAP/SMTP, database, security, and plugins carefully. With proper setup, Roundcube provides a modern, customizable, and user-friendly webmail interface.

// ---------------------------------------------------------------------
// WARNING: Do not edit this file! Copy configuration to config.inc.php.
// ---------------------------------------------------------------------
/*
 +-----------------------------------------------------------------------+
 | Default settings for all configuration options                        |
 | This file is part of the Roundcube Webmail client                      |
 | Copyright (C) The Roundcube Dev Team                                  |
 | Licensed under the GNU General Public License version 3 or later      |
 +-----------------------------------------------------------------------+
*/

$config = [];

// ----------------------------------
// SQL DATABASE
// ----------------------------------
$config['db_dsnw'] = 'mysql://roundcube:@localhost/roundcubemail';
$config['db_dsnr'] = '';
$config['db_persistent'] = false;
$config['db_prefix'] = '';

// ----------------------------------
// LOGGING/DEBUGGING
// ----------------------------------
$config['log_driver'] = 'file';
$config['log_date_format'] = 'd-M-Y H:i:s O';
$config['log_session_id'] = 8;
$config['per_user_logging'] = false;
$config['smtp_log'] = true;
$config['log_logins'] = false;
$config['sql_debug'] = false;
$config['imap_debug'] = false;
$config['smtp_debug'] = false;

// ----------------------------------
// IMAP
// ----------------------------------
$config['imap_host'] = 'localhost:143';
$config['imap_auth_type'] = null;
$config['imap_delimiter'] = null;
$config['imap_cache'] = null;
$config['messages_cache'] = false;

// ----------------------------------
// SMTP
// ----------------------------------
$config['smtp_host'] = 'localhost:587';
$config['smtp_user'] = '%u';
$config['smtp_pass'] = '%p';
$config['smtp_auth_type'] = null;

// ----------------------------------
// SYSTEM
// ----------------------------------
$config['enable_installer'] = false;
$config['auto_create_user'] = true;
$config['log_dir'] = RCUBE_INSTALL_PATH . 'logs/';
$config['temp_dir'] = RCUBE_INSTALL_PATH . 'temp/';
$config['des_key'] = 'rcmail-!24ByteDESkey*Str';
$config['cipher_method'] = 'DES-EDE3-CBC';
$config['product_name'] = 'Roundcube Webmail';
$config['skin'] = 'elastic';
$config['language'] = null;
$config['default_charset'] = 'ISO-8859-1';

// ----------------------------------
// USER INTERFACE
// ----------------------------------
$config['mail_pagesize'] = 50;
$config['addressbook_pagesize'] = 50;
$config['prefer_html'] = true;
$config['htmleditor'] = 0;
$config['draft_autosave'] = 300;
$config['refresh_interval'] = 60;
$config['check_all_folders'] = false;
$config['drafts_mbox'] = 'Drafts';
$config['junk_mbox'] = 'Junk';
$config['sent_mbox'] = 'Sent';
$config['trash_mbox'] = 'Trash';
$config['create_default_folders'] = false;
$config['protect_default_folders'] = true;

// ----------------------------------
// PLUGINS
// ----------------------------------
$config['plugins'] = [];