Changes between Version 5 and Version 6 of Howto_Config

Timestamp:

Mar 27, 2007 6:37:02 PM (6 years ago)

Author:

tgreiser

Comment:

virtuser instructions

Howto_Config

@@ -59 +59 @@
 
 This will allow you to delete top level folders. Change back to TRUE when you are done in order to prevent users from accidentally deleting the default folders.
+
+
+=== Configuring for Virtual Users ===
+
+Virtual users are useful for hosting providers where a single mailserver is providing email for a number of different domains.  The goal is that the user logs in to roundcube with their email login/password, and roundcube knows where to lookup their complete email address.  Two options are support, SQL lookups or a sendmail style virtuser file.
+
+In order to test if virtuser is configured correctly, log in to roundcube with a user that does not exist yet.  Compose a message, if you see the From address as user@correct_domain, then it worked.  If you see user@localhost, something is wrong.  To reset and try again, delete that user from the roundcube users and identities tables.
+
+1) virtuser_file
+{{{
+$rcmail_config['virtuser_file'] = '/etc/mail/virtuser';
+}}}
+
+This assumes that the file /etc/mail/virtuser contains information about your virtual users in the following format:
+
+{{{
+user@domain login1
+user@domain login2
+}}}
+
+2) virtuser_query (SQL)
+{{{
+$rcmail_config['virtuser_query'] = "SELECT email_address FROM database.table WHERE login = '%u'";
+}}}
+
+If you are using postfix and/or some kind of hosting panel, chances are your email accounts are already stored in a SQL table. If that is the case, you want to lookup the emails with a virtuser_query.  The parts of the example query:
+
+{{{
+// email_address - the first column returned by the query must be the complete email address
+// database - name of the database where your table is located, the roundcube db user must have read access
+// table - name of the table where your email addresses are stored
+// login - name of the field that contains the username that is used to log in to roundcube (and send/receive email)
+}}}