From the list below choose one of our FAQs topics, then select a FAQ to read. If you have a question which is not in this section, please contact us .

Why did the Roundcube installer fail?

The installation failed

There’s a good chance your postgres database is damaged. Open the logs and if you see lines similar to below, you have a postgres database issue.

 database system was interrupted record with zero length invalid primary checkpoint record 

You will find the log here:

 /Library/Logs/PostgreSQL/PostgreSQL.log 

The Roundcube installer needs a healthy database.
Repair Postgres and try the Roundcube installer again.

How do I view logs for topicdesk-Roundcube

You’ll want to increase logging first, so edit:

/usr/local/topicdesk/roundcube/WebApp/config/main.inc.php 

You will find several logging options, here a few options with default settings.
Change them to suit your needs.

 $rcmail_config['debug_level'] = 1; $rcmail_config['log_logins'] = false; $rcmail_config['log_session'] = false; $rcmail_config['imap_debug'] = false; $rcmail_config['smtp_debug'] = false; 

Logs will be saved to:

 /usr/local/topicdesk/roundcube/WebApp/logs/ 

How do I modify the topicdesk-Roundcube configuration

To make changes to the Roundcube configuration, there are two files to be considered.

This file contains Roundcube default settings. Use this as a reference, but don’t make changes to this file.
/usr/local/topicdesk/roundcube/WebApp/config/defaults.inc.php

To make a change, copy the line(s) from defaults.inc.php and add it to with your change to:
/usr/local/topicdesk/roundcube/WebApp/config/config.inc.php

The config.inc.php file should contain all or your settings, they override the defaults.inc.php settings.

What is virtual mail hosting or are virtual mail domains

A quote from Apple’s documentation:

Virtual hosting is a method you can use to host more than one domain name on the same computer and IP address, with overlapping mail user names.

For example, a mail server can receive mail transfer requests for two domains, mail.example1.com and mail.example2.com, both of which resolve to the same IP address. For mail.example1.com, the server delivers mail to “[email protected]” to a user mailbox for “bob,” while it also delivers mail to “[email protected]” to a different user mailbox. Virtual hosts are essentially the converse of local host aliases.

So when do you need to use virtual domains?

If you host mail for many organizations, and you need [email protected] to be a different mailbox than [email protected], then you need to use virtual domains for your mail service.

The typical small business with a few domains, does usually not need to enable virtual domains. [email protected] and [email protected] are the same person and use the same mailbox.

How can I manage the Mail Queue

View the Mail Queue

sudo mailq

Need details of a message in the queue?
Every message has a Queue ID. Copy the ID after running the mailq command.

sudo find /var/spool/postfix/deferred/ -name ECCB516EB4017 -exec cat {} \;

Delete a message

sudo postsuper -d ECCB516EB4017

Delete all messages in the mail queue

sudo postsuper -d ALL