Group-Office installation
Decompress the Group-Office files in the document root of Apache. Start the installation by pointing your web browser to the address: http://<your Group-Office installation>/install/install.php. The installler will guide you through this process.
Setting up the Group-Office update client
Click here for installation instructions
E-mail Authentication
It's possible to authenticate users using an IMAP or POP03 server. It can be very useful to use the user accounts of an existing e-mail environment in Group-Office. To set this up you need to rename the file “auth_sources.dist” to “auth_sources.inc”. After this you must set the path to this file in “config.php”:
$config['auth_sources']='/var/www/html/groupoffice/auth_sources.inc';
Add the following to this file:
array(
'type' => 'email',
'name' => 'intermesh.nl',
'user_manager' => 'sql',
'proto' => 'imap',
'domain' => 'intermesh.nl',
'host' => 'localhost',
'port' => '143',
'ssl' => false,
'novalidate_cert' => false,
'mbroot' => 'INBOX',
'add_domain_to_username' => false,
'create_email_account' => true,
'auto_check_email' => true,
'groups' => array('Intermesh'),
'visible_groups' => array('Everyone'),
'modules_read' => array('email', 'addressbook', 'calendar', 'summary'),
'modules_write' => array()
);
type
The type of the authentication source. In this case '”mail”. It can also be “ldap” but this is still in expirimental stages.
name
The name of the authentication source as it will appear in a pulldown menu when there are more then one authentication sources defined.
user_manager
The type of user management you wish to use. This can be “sql”, 'passwd” en “ldap” zijn. By default “sql” is used. It can however be very useful to use “passwd”. With this option system accounts are changed when you change the password in Group-Office.
This is only possible when the mailserver runs on the local machine (“localhost”) and you must allow the Apache system users to execute the command “chpasswd”. This can be done with the program “sudo”. add the following line to /etc/sudoers using the “visudo” command:
apache ALL=NOPASSWD:/usr/sbin/chpasswd
Replace the apache username if nessecary. Also check the path of chpasswd. If this path is different then you must also change this path in “config.php”.
proto
The protocol. Can be IMAP or POP-3. IMAP is highly recommended. POP-3 is slow and doesn't offer the use of multiple e-mail folders.
domain
The domain of the e-mail addresses.
host
The hostname of the machine where the mailserver runs.
port
The port . For IMAP usually 143 and for POP-3 usually 110.
ssl
SSL mode on or off
novalidate_cert
Validate the SSL certificate yes or no. with some mailservers you must enable this feature always even if you don't use SSL.
mbroot
The mailbox root. In most cases you can leave this value empty. It could be that you must enter “INBOX” or “mail” here.
add_domain_to_username
Enable this option if you need to login with the full e-mail address at the mailserver.
create_email_account
If you want to create an e-mail account in Group-Office automatically when a user logs in the first time enable this option.
auto_check_email
Check the automatic e-mail account for new messages automatically.
groups
Add the new users to these user groups automatically.
visible_groups
Make new users automatically visible to these user groups.
modules_read
Grant new users read permissions to these modules.
modules_write
Grant new users administrator permissions to these modules.
