2014-09-30 10:13:21 -05:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
2015-01-14 03:25:16 -06:00
< title > Install SOGo groupware on CentOS 6 with iRedMail (MySQL backend)< / title >
2015-07-31 23:14:52 -05:00
< link rel = "stylesheet" type = "text/css" href = "./css/markdown.css" / >
2014-09-30 10:13:21 -05:00
< / head >
< body >
< div id = "navigation" >
2016-02-28 09:31:56 -06:00
< a href = "http://www.iredmail.org" target = "_blank" > < img alt = "iRedMail web site" src = "images/logo-iredmail.png" style = "vertical-align: middle; height: 30px;" / > < span > iRedMail< / span > < / a >
2014-09-30 10:13:21 -05:00
// < a href = "./index.html" > Document Index< / a >
2015-01-14 03:25:16 -06:00
< / div > < h1 id = "install-sogo-groupware-on-centos-6-with-iredmail-mysql-backend" > Install SOGo groupware on CentOS 6 with iRedMail (MySQL backend)< / h1 >
2014-09-30 10:13:21 -05:00
< div class = "toc" >
< ul >
2015-01-14 03:25:16 -06:00
< li > < a href = "#install-sogo-groupware-on-centos-6-with-iredmail-mysql-backend" > Install SOGo groupware on CentOS 6 with iRedMail (MySQL backend)< / a > < ul >
2014-09-30 10:13:21 -05:00
< li > < a href = "#requirements" > Requirements< / a > < / li >
< li > < a href = "#install-sogo" > Install SOGo< / a > < / li >
2015-01-14 03:25:16 -06:00
< li > < a href = "#create-required-sql-database" > Create required SQL database< / a > < / li >
2014-09-30 10:13:21 -05:00
< li > < a href = "#configure-sogo" > Configure SOGo< / a > < / li >
2015-01-14 10:09:13 -06:00
< li > < a href = "#configure-web-server" > Configure web server< / a > < ul >
2014-10-12 05:03:59 -05:00
< li > < a href = "#apache-web-server" > Apache web server< / a > < / li >
< li > < a href = "#nginx-web-server" > Nginx web server< / a > < / li >
< / ul >
< / li >
2014-09-30 10:13:21 -05:00
< li > < a href = "#start-sogo-and-dependent-services" > Start SOGo and dependent services< / a > < / li >
2015-01-14 10:09:13 -06:00
< li > < a href = "#add-dovecot-master-user-used-for-vacation-message-expiration" > Add Dovecot Master User, used for vacation message expiration< / a > < / li >
< li > < a href = "#add-required-cron-jobs" > Add required cron jobs< / a > < / li >
2015-01-14 03:25:16 -06:00
< li > < a href = "#access-sogo-from-web-browser" > Access SOGo from web browser< / a > < / li >
< li > < a href = "#configure-your-mail-clients-or-mobile-devices-to-use-caldavcarddav-services" > Configure your mail clients or mobile devices to use CalDav/CardDAV services< / a > < / li >
2015-11-06 09:02:46 -06:00
< li > < a href = "#references" > References< / a > < / li >
2014-09-30 10:13:21 -05:00
< / ul >
< / li >
< / ul >
< / div >
< h2 id = "requirements" > Requirements< / h2 >
< ul >
< li > A working iRedMail server (MySQL backend) on CentOS 6.< / li >
< / ul >
< h2 id = "install-sogo" > Install SOGo< / h2 >
< ul >
< li > Make sure you have EPEL repo enabled, if not, please follow < a href = "https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F" > this wiki
tutorial< / a >
to enable it.< / li >
< / ul >
< pre > < code > # yum repolist | grep -i 'epel'
epel Extra Packages for Enterprise Linux 6 - x86_64 11,109
< / code > < / pre >
< ul >
< li > Add yum repo file < code > /etc/yum.repos.d/sogo.repo< / code > :< / li >
< / ul >
< pre > < code > [SOGo]
name=Inverse SOGo Repository
baseurl=http://inverse.ca/downloads/SOGo/RHEL6/$basearch
gpgcheck=0
< / code > < / pre >
< ul >
< li > Install SOGo and dependences:< / li >
< / ul >
2015-01-14 03:25:16 -06:00
< pre > < code > # yum install sogo sope49-gdl1-mysql sogo-activesync sogo-ealarms-notify sogo-tool
< / code > < / pre >
< ul >
< li > Append an alias entry in Postfix config file < code > /etc/postfix/aliases< / code > , so that
notifications of cron jobs will be sent to mail server administrator.< / li >
< / ul >
< pre > < code > # Part of file: /etc/postfix/aliases
sogo: root
2014-09-30 10:13:21 -05:00
< / code > < / pre >
2015-01-14 03:25:16 -06:00
< p > Execute command to update alias db:< / p >
< pre > < code > # postalias /etc/postfix/aliases
< / code > < / pre >
< h2 id = "create-required-sql-database" > Create required SQL database< / h2 >
< p > SOGo will store some data (e.g. user preferences, sieve rules) in SQL database,
so we need to create a database for it.< / p >
2014-09-30 10:13:21 -05:00
< pre > < code > $ mysql -u root -p
mysql> CREATE DATABASE sogo CHARSET='UTF8';
mysql> GRANT ALL ON sogo.* TO sogo@localhost IDENTIFIED BY 'password';
mysql> GRANT SELECT ON vmail.mailbox TO sogo@localhost;
2015-01-14 03:25:16 -06:00
mysql> CREATE VIEW sogo.users (c_uid, c_name, c_password, c_cn, mail, home) AS SELECT username, username, password, name, username, CONCAT(storagebasedirectory, '/', storagenode, '/', maildir) FROM vmail.mailbox WHERE active=1;
2014-09-30 10:13:21 -05:00
< / code > < / pre >
2015-01-14 03:25:16 -06:00
< p > Note: SOGo will create required SQL tables automatically, we don't need to
create them manually.< / p >
2014-09-30 10:13:21 -05:00
< h2 id = "configure-sogo" > Configure SOGo< / h2 >
2015-01-14 03:25:16 -06:00
< p > Default SOGo config file is < code > /etc/sogo/sogo.conf< / code > . We have a sample config file
for you, just replace MySQL username/password in this file, then it's done.< / p >
< p > With below config file, SOGo will listen on address < code > 127.0.0.1< / code > , port < code > 20000< / code > .< / p >
2014-10-12 05:03:59 -05:00
< pre > < code > {
2015-01-14 03:25:16 -06:00
// Official SOGo documents:
// - http://www.sogo.nu/english/support/documentation.html
// - http://wiki.sogo.nu
//
// Mailing list:
// - http://www.sogo.nu/english/support/community.html
// Enable verbose logging. Reference:
// http://www.sogo.nu/nc/support/faq/article/how-to-enable-more-verbose-logging-in-sogo.html
//ImapDebugEnabled = YES;
//LDAPDebugEnabled = YES;
//MySQL4DebugEnabled = YES;
//PGDebugEnabled = YES;
// Daemon address and port
2014-09-30 10:13:21 -05:00
WOPort = 127.0.0.1:20000;
2015-01-14 03:25:16 -06:00
// PID file
2015-02-15 03:29:35 -06:00
//WOPidFile = /var/run/sogo/sogo.log;
// Log file
//WOLogFile = /var/log/sogo/sogo.log;
2015-01-14 03:25:16 -06:00
// IMAP connection pool.
// Your performance will slightly increase, as you won't open a new
// connection for every access to your IMAP server.
// But you will get a lot of simultaneous open connections to your IMAP
// server, so make sure he can handle them.
// For debugging it is reasonable to turn pooling off.
//NGImap4DisableIMAP4Pooling = NO;
SOGoProfileURL = " mysql://sogo:password@127.0.0.1:3306/sogo/sogo_user_profile" ;
OCSFolderInfoURL = " mysql://sogo:password@127.0.0.1:3306/sogo/sogo_folder_info" ;
OCSSessionsFolderURL = " mysql://sogo:password@127.0.0.1:3306/sogo/sogo_sessions_folder" ;
// Default language in the web interface
SOGoLanguage = English;
// Specify which module to show after login: Calendar, Mail, Contacts.
SOGoLoginModule = Mail;
// Must login with full email address
SOGoForceExternalLoginWithEmail = YES;
// Allow user to change full name and email address.
SOGoMailCustomFromEnabled = YES;
2014-09-30 10:13:21 -05:00
2014-10-12 05:03:59 -05:00
// Enable email-based alarms on events and tasks.
SOGoEnableEMailAlarms = YES;
2015-01-14 03:25:16 -06:00
OCSEMailAlarmsFolderURL = " mysql://sogo:password@127.0.0.1:3306/sogo/sogo_alarms_folder" ;
2014-10-12 05:03:59 -05:00
2015-01-14 03:25:16 -06:00
// IMAP server
2014-10-30 07:22:36 -06:00
//SOGoIMAPServer = " imaps://127.0.0.1:143/?tls=YES" ;
// Local connection is considered as secure by Dovecot.
SOGoIMAPServer = " imap://127.0.0.1:143/" ;
2014-09-30 10:13:21 -05:00
2015-01-14 03:25:16 -06:00
// SMTP server
2014-09-30 10:13:21 -05:00
SOGoMailingMechanism = smtp;
SOGoSMTPServer = 127.0.0.1;
2015-01-14 03:25:16 -06:00
//SOGoSMTPAuthenticationType = PLAIN;
2014-09-30 10:13:21 -05:00
// Enable managesieve service
2014-10-30 07:22:36 -06:00
//
// WARNING: Sieve scripts generated by SOGo is not compatible with Roundcube
// webmail, don't use sieve service in both webmails, otherwise
// it will be messy.
//
2015-01-14 03:25:16 -06:00
//SOGoSieveServer = sieve://127.0.0.1:4190;
2014-10-30 07:22:36 -06:00
//SOGoSieveScriptsEnabled = YES;
//SOGoVacationEnabled = YES;
//SOGoForwardEnabled = YES;
2014-09-30 10:13:21 -05:00
2015-01-14 03:25:16 -06:00
// Memcached
2014-09-30 10:13:21 -05:00
SOGoMemcachedHost = 127.0.0.1;
2015-01-14 03:25:16 -06:00
SOGoTimeZone = " America/New_York" ;
2014-09-30 10:13:21 -05:00
SOGoFirstDayOfWeek = 1;
2015-01-14 03:25:16 -06:00
SOGoRefreshViewCheck = every_5_minutes;
SOGoMailReplyPlacement = below;
2014-09-30 10:13:21 -05:00
SOGoAppointmentSendEMailNotifications = YES;
SOGoFoldersSendEMailNotifications = YES;
SOGoACLsSendEMailNotifications = YES;
2015-01-14 03:25:16 -06:00
// PostgreSQL cannot update view
2014-09-30 10:13:21 -05:00
SOGoPasswordChangeEnabled = YES;
2015-01-14 03:25:16 -06:00
// Authentication using SQL
SOGoUserSources = (
2014-09-30 10:13:21 -05:00
{
type = sql;
2015-01-14 03:25:16 -06:00
id = vmail_mailbox;
2014-10-30 07:22:36 -06:00
viewURL = " mysql://sogo:password@127.0.0.1:3306/sogo/users" ;
2014-09-30 10:13:21 -05:00
canAuthenticate = YES;
2015-01-14 03:25:16 -06:00
// Default algorithm used when changing passwords.
userPasswordAlgorithm = ssha;
2014-09-30 10:13:21 -05:00
prependPasswordScheme = YES;
2014-10-30 07:22:36 -06:00
2015-01-14 03:25:16 -06:00
// Use vmail.mailbox as global address book.
// WARNING: This will search all user accounts, not just accounts
// under same domain as login user.
//isAddressBook = YES;
//displayName = " Global Address Book" ;
2014-09-30 10:13:21 -05:00
}
);
2014-10-12 05:03:59 -05:00
}
2014-09-30 10:13:21 -05:00
< / code > < / pre >
2015-01-18 00:19:16 -06:00
< p > Important note: sieve rules generated by SOGo is not compatible with Roundcube
webmail, so if you're running both Roundcube and SOGo, you must disable sieve
support (including forwarding and vacation support) in one of them to avoid
incompatible sieve rules. if you choose to run only SOGo, you can enable sieve
support by removing comment mark of below lines in above configuration:< / p >
< pre > < code > SOGoSieveServer = sieve://127.0.0.1:4190;
SOGoSieveScriptsEnabled = YES;
SOGoVacationEnabled = YES;
SOGoForwardEnabled = YES;
< / code > < / pre >
2015-01-14 10:09:13 -06:00
< h2 id = "configure-web-server" > Configure web server< / h2 >
< p > To access SOGo groupware (webmail/calendar/contact), we need to configure
web server.< / p >
2014-10-12 05:03:59 -05:00
< h3 id = "apache-web-server" > Apache web server< / h3 >
2015-02-18 03:37:41 -06:00
< ul >
< li > SOGo installs Apache config file < code > /etc/httpd/conf.d/SOGo.conf< / code > by default,
please open it and find below lines:< / li >
< / ul >
2014-10-12 05:03:59 -05:00
< pre > < code > #ProxyPass /Microsoft-Server-ActiveSync \
# http://127.0.0.1:20000/SOGo/Microsoft-Server-ActiveSync \
# retry=60 connectiontimeout=5 timeout=360
< / code > < / pre >
< p > Remove < code > #< / code > at the beginning to enable ActiveSync support:< / p >
< pre > < code > ProxyPass /Microsoft-Server-ActiveSync \
http://127.0.0.1:20000/SOGo/Microsoft-Server-ActiveSync \
retry=60 connectiontimeout=5 timeout=360
< / code > < / pre >
2015-02-18 03:37:41 -06:00
< ul >
< li > Find string < code > yourhostname< / code > in the same file, replace all < code > yourhostname< / code > by
your FQDN server hostname. (Tip: you can get your FQDN hostname with command
< code > hostname -f< / code > .)< / li >
< / ul >
2014-10-12 05:03:59 -05:00
< h3 id = "nginx-web-server" > Nginx web server< / h3 >
2015-01-14 03:25:16 -06:00
< p > If you're running Nginx web server configured by iRedMail, please open file
< code > /etc/nginx/conf.d/default.conf< / code > , add some lines in < code > server {}< / code > configured for
HTTPS:< / p >
2014-10-12 05:03:59 -05:00
< pre > < code > server {
listen 443;
...
# Add below lines for SOGo
# SOGo
2015-01-14 03:25:16 -06:00
location ~ ^/sogo { rewrite ^ https://$host/SOGo; }
location ~ ^/SOGO { rewrite ^ https://$host/SOGo; }
# For IOS 7
location = /principals/ {
rewrite ^ https://$server_name/SOGo/dav;
allow all;
}
2014-10-12 05:03:59 -05:00
location ^~ /SOGo {
proxy_pass http://127.0.0.1:20000;
#proxy_redirect http://127.0.0.1:20000/SOGo/ /SOGo;
# forward user's IP address
#proxy_set_header X-Real-IP $remote_addr;
#proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
#proxy_set_header Host $host;
proxy_set_header x-webobjects-server-protocol HTTP/1.0;
#proxy_set_header x-webobjects-remote-host 127.0.0.1;
#proxy_set_header x-webobjects-server-name $server_name;
#proxy_set_header x-webobjects-server-url $scheme://$host;
}
location ^~ /Microsoft-Server-ActiveSync {
proxy_pass http://127.0.0.1:20000/SOGo/Microsoft-Server-ActiveSync;
proxy_redirect http://127.0.0.1:20000/Microsoft-Server-ActiveSync /;
}
location ^~ /SOGo/Microsoft-Server-ActiveSync {
proxy_pass http://127.0.0.1:20000/SOGo/Microsoft-Server-ActiveSync;
proxy_redirect http://127.0.0.1:20000/SOGo/Microsoft-Server-ActiveSync /;
}
location /SOGo.woa/WebServerResources/ {
2015-01-14 03:25:16 -06:00
alias /usr/lib64/GNUstep/SOGo/WebServerResources/;
2014-10-12 05:03:59 -05:00
}
location /SOGo/WebServerResources/ {
2015-01-14 03:25:16 -06:00
alias /usr/lib64/GNUstep/SOGo/WebServerResources/;
2014-10-12 05:03:59 -05:00
}
location ^/SOGo/so/ControlPanel/Products/([^/]*)/Resources/(.*)$ {
2015-01-14 03:25:16 -06:00
alias /usr/lib64/GNUstep/SOGo/$1.SOGo/Resources/$2;
2014-10-12 05:03:59 -05:00
}
}
< / code > < / pre >
2015-01-14 03:25:16 -06:00
< p > < strong > Important note< / strong > : You must replace path < code > /usr/lib/GNUstep/SOGo< / code > with
2014-10-12 05:03:59 -05:00
the real directory which contains SOGo files:< / p >
< ul >
2015-01-14 03:25:16 -06:00
< li > on i386 platform, it's < code > /usr/lib/GNUstep/SOGo< / code > .< / li >
< li > on x86_64, it's < code > /usr/lib64/GNUstep/SOGo< / code > .< / li >
2014-10-12 05:03:59 -05:00
< / ul >
2014-09-30 10:13:21 -05:00
< h2 id = "start-sogo-and-dependent-services" > Start SOGo and dependent services< / h2 >
2015-01-14 10:09:13 -06:00
< pre > < code > # service httpd restart # < - restart 'nginx' service if you're running Nginx
2015-01-14 03:25:16 -06:00
# service memcached restart
2015-01-14 10:09:13 -06:00
# service sogod restart
< / code > < / pre >
< h2 id = "add-dovecot-master-user-used-for-vacation-message-expiration" > Add Dovecot Master User, used for vacation message expiration< / h2 >
2015-01-17 21:50:10 -06:00
< p > SOGo need a Dovecot Master User to cleanup vacation expiration, please follow
2015-01-18 00:19:16 -06:00
our tutorial to add a Dovecot Master User for this purpose: < a href = "./dovecot.master.user.html" > Dovecot Master User< / a > .< / p >
< p > After added a Dovecot Master User for SOGo, we must store its username and
plain password in a separate file used by SOGo, we use < code > /etc/sogo/sieve.cred< / code >
here for example.< / p >
< p > Create file < code > /etc/sogo/sieve.cred< / code > , write Dovecot Master User in this file in
format: < code > username:password< / code > . For example:< / p >
< pre > < code > my_master_user@non-exist.com:my_master_password
< / code > < / pre >
< p > Set strict file owner and permission:< / p >
< pre > < code > # chown sogo:sogo /etc/sogo/sieve.cred
# chmod 0400 /etc/sogo/sieve.cred
< / code > < / pre >
2015-01-14 10:09:13 -06:00
< h2 id = "add-required-cron-jobs" > Add required cron jobs< / h2 >
< p > Please add below cron jobs for SOGo daemon user < code > sogo< / code > . You can add them with
command: < code > crontab -l -u sogo< / code > < / p >
< pre > < code > # iRedMail: SOGo email reminder, should be run every minute.
* * * * * /usr/sbin/sogo-ealarms-notify
# iRedMail: SOGo session cleanup, should be run every minute.
# Ajust the [X]Minutes parameter to suit your needs
# Example: Sessions without activity since 30 minutes will be dropped:
* * * * * /usr/sbin/sogo-tool expire-sessions 30
# iRedMail: SOGo vacation messages expiration
# The credentials file should contain the sieve admin credentials (username:passwd)
0 0 * * * /usr/sbin/sogo-tool expire-autoreply -p /etc/sogo/sieve.cred
2014-09-30 10:13:21 -05:00
< / code > < / pre >
2015-01-14 03:25:16 -06:00
< h2 id = "access-sogo-from-web-browser" > Access SOGo from web browser< / h2 >
< p > Open your favourite web browser, access URL: < code > https://[your_server]/SOGo< / code > (the
word < code > SOGo< / code > is case-sensitive), you can login with your email account credential.< / p >
< h2 id = "configure-your-mail-clients-or-mobile-devices-to-use-caldavcarddav-services" > Configure your mail clients or mobile devices to use CalDav/CardDAV services< / h2 >
< p > Please check our documents < a href = "./index.html#configure-mail-client-applications" > here< / a >
2015-11-06 09:02:46 -06:00
to configure your mail clients or mobile devices.< / p >
< h2 id = "references" > References< / h2 >
< ul >
< li > < a href = "http://sogo.nu" > SOGo web site< / a > < / li >
< li >
< p > Outlook plugins:< / p >
< ul >
< li >
< p > < a href = "https://github.com/aluxnimm/outlookcaldavsynchronizer" > Outlook CalDav Synchronizer< / a > < / p >
< blockquote >
< p > Outlook Plugin, which synchronizes events, tasks and contacts(beta) between Outlook and Google, SOGo, Horde or any other CalDAV or CardDAV server. Supported Outlook versions are 2016, 2013, 2010 and 2007.< / p >
< / blockquote >
< / li >
< / ul >
< / li >
2015-12-13 23:04:21 -06:00
< / ul > < p style = "text-align: center; color: grey;" > All documents are available in < a href = "https://bitbucket.org/zhb/iredmail-docs/src" > BitBucket repository< / a > , and published under < a href = "http://creativecommons.org/licenses/by-nd/3.0/us/" target = "_blank" > Creative Commons< / a > license. If you found something wrong, please do < a href = "http://www.iredmail.org/contact.html" > contact us< / a > to fix it.< script >
2015-02-05 07:02:53 -06:00
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-3293801-21', 'auto');
ga('send', 'pageview');
2014-10-13 19:28:43 -05:00
< / script >
< / body > < / html >
