summaryrefslogtreecommitdiff
path: root/office/SOGo/README.SBo
blob: 16923b3c2b91f5a94b5059fb18dddf8bd44f371a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
Thar be bears!
==============
The SOGo group recommends the following versions of gnustep-make and
gnustep-base when running SOGo:

  * gnustep-make version 2.6.6
  * gnustep-base version 1.24.6

Running SOGo with versions other than the ones suggested can result in
SOGo not working properly and many hours of time wasted until you
happen upon just the right forum post that explains the situation.

How do I configure this?
========================
If you set INSTALL_DOCS=yes when you built this package you should have
some documentation in PDF form in the doc folder for this package.

If you opted out of installing the documentation or you want a more recent
version of the documentation you can look here
https://sogo.nu/support.html#/documentation.

Automatically starting SOGo
===========================
To start SOGo automatically at system startup, add the following to
your /etc/rc.d/rc.local:

  if [ -x /etc/rc.d/rc.sogod ]; then
    /etc/rc.d/rc.sogod start
  fi

To stop sogo automatically at system shutdown, add the following to
your /etc/rc.d/rc.local_shutdown:

  if [ -x /etc/rc.d/rc.sogod ]; then
    /etc/rc.d/rc.sogod stop
  fi

Adding users
============
Users are automatically added to the SOGo groupware server whenever they
successfully log onto it with valid IMAP credentials.

Removing users
==============
Removing requires the use of the sogo-tool utility.  You can remove a
user like so:

  $ /usr/sbin/sogo-tool remove USERID

Configuration file issues
=========================
The documentation outlines the format required when trying to use TLS
with the SOGoIMAPServer and SOGoSieveServer values in the
/etc/sogo/sogo.conf file.  Unfortunately, what is described doesn't
quite work as described.  In order for this to work you'll need to quote
the parameters, like so:

  ..
  SOGoIMAPServer = "imap://127.0.0.1:143/?tls=YES";
  ..
  SOGoSieveServer = "sieve://127.0.0.1:4190/?tls=YES";
  ..

If you ignore the quotes, these two parameters will not work when using
TLS.