Provided by: kopano-server_8.5.5-0ubuntu1_amd64 bug

NAME

       kopano-server.cfg - The Kopano configuration file

SYNOPSIS

       server.cfg

DESCRIPTION

       The server.cfg is a configuration file for the kopano-server process.  server.cfg contains instructions
       for the software to set up the database environment, logging system and user backend.

FILE FORMAT

       The file consists of one big section, but parameters can be grouped by functionality.

       The parameters are written in the form:

       name = value

       The file is line-based. Each newline-terminated line represents either a comment, nothing, a parameter or
       a directive. A line beginning with `#' is considered a comment, and will be ignored by Kopano. Parameter
       names are case sensitive. Lines beginning with `!' are directives.

       Directives are written in the form:

       !directive [argument(s)]

       The following directives exist:

       include
           Include and process argument

           Example: !include common.cfg

EXPLANATION OF THE SERVER SETTINGS PARAMETERS

       server_listen
              A  space-separated  list  of  address:port  specifiers  for  where  the  server  should listen for
              unencrypted connections. IPv6 addresses need to be enclosed in brackets (as in  [2a01:db1::]:236),
              and the asterisk is the multi-protocol address wildcard.

       server_bind
              This historic directive specifies a single IPv4/IPv6 address to bind to. Its use is discouraged in
              favor of server_listen and server_listen_tls.

       server_tcp_enabled, server_tcp_port
              These historic directive specify the single port to bind to for unencrypted connections. Their use
              is discouraged in favor of server_listen. The address is mandated by server_bind.

       server_pipe_enabled
           Enable Unix pipe connections. Should not be disabled.

           Default: yes

       server_recv_timeout
           TCP  and  SSL receive timeout in seconds. This is the time that a TCP connection may be idle (between
           requests) before the TCP connection is closed from the server.  Settings  this  high  makes  it  less
           necessary for clients to re-connect, but increases the total number of concurrent open sockets in the
           server. You normally needn't change the default value.

           Default: 5

       server_read_timeout
           TCP and SSL read timeout in seconds. The read timeout is the amount of time that the server will wait
           to read more data from a socket, after processing of the request has started. This needn't be changed
           in most cases.

           Default: 60

       server_send_timeout
           TCP and SSL send timeout in seconds. The send timeout is the amount of time that the server will wait
           to write data to a socket, analogous to server_read_timeout.

           Default: 60

       server_pipe_name
           Unix socket to listen on.

           Default: /var/run/kopano/server.sock

       server_pipe_priority
           Priority  unix  socket  to listen on. This socket should only be used by prioritized services such as
           kopano-stats.

           Default: /var/run/kopano/prio.sock

       server_name
           Unique name for identifying the server in a multi-server environment.

           Default: Kopano

       server_hostname
           DNS name of the server. This is used for the Kerberos single sign-on environment. If empty (default),
           the FQDN or hostname will be used.

           Default:

       database_engine
           The database engine to use. Values can be:

           mysql
               Use MySQL.

           Default: mysql

       allow_local_users
           Named Unix users which connect through the unix socket (server_pipe_name) which are added here, those
           users will become the internal SYSTEM user in Kopano, and have administrative rights. Normally,  this
           is only 'root', so the unix root user can use the kopano-admin tool. You can add a generic user to be
           used by the kopano-dagent here. This user is most likely called 'vmail'. Note that the field is SPACE
           separated.

           Default: root

       system_email_address
           This  is  the  e-mail address of the SYSTEM user. When people receive mail from the quota monitor, or
           receive fallback deliveries from the kopano-dagent, the From email address is this field.  You  might
           want to change this field so people can reply to this address.

           Default: postmaster@localhost

       run_as_user
           After  correctly  starting,  the server process will become this user, dropping root privileges. Note
           that the log file needs to be writeable by this user, and the directory too to  create  new  logfiles
           after logrotation. This can also be achieved by setting the correct group and permissions.

           Default value is empty, not changing the user after starting.

       run_as_group
           After correctly starting, the server process will become this group, dropping root privileges.

           Default value is empty, not changing the group after starting.

       pid_file
           Write the process ID number to this file. This is used by the init.d script to correctly stop/restart
           the service.

           Default: /var/run/kopano/server.pid

       running_path
           Change  directory to this path when running in daemonize mode. When using the -F switch to run in the
           foreground the directory will not be changed.

           Default: /

       coredump_enabled
           When a crash occurs or an assertion fails, a coredump file can be generated.   This  file  should  be
           sent  along  with the crash report. It is turned on by default in Kopano, but your system may have it
           disabled. For details, see the kopano-coredump(5) manpage.

       session_timeout
           The session timeout specifies how many seconds must elapse without any activity from a client  before
           the  server  counts the session as dead. The client sends keepalive requests every 60 seconds, so the
           session timeout can never be below 60. In fact, if you specify a timeout below 300, 300 will be taken
           as the session timeout instead. This makes sure you can never timeout your session while  the  Kopano
           client is running.

           Setting  the  session  timeout  low will keep the session count and therefore the memory usage on the
           server low, but may also timeout sessions of client that have lost network connectivity  temporarily.
           For  example,  some  clients  with  powersaving  modes  will  disable  the  ethernet  card during the
           screensaver. When this happens, you must set the session_timeout to a value that is higher  than  the
           time  that  it  takes  for  the network connection to come back. This could be anything ranging up to
           several hours.

           Default: 300

       session_ip_check
           Normally, a session is linked to an IP-address, so this check is enabled. You  may  want  to  disable
           this  check  when  you  have  laptop's  which can get multiple ip-adresses through wired and wireless
           networks. It is highly recommended to leave this check enabled, since the session id can be  used  by
           other machines, and thus introduces a large security risc. The session id is 64 bits.

           Default: yes

       hide_everyone
           If this option is set to 'yes', the internal group Everyone (which always contains all users) will be
           hidden  from  the  Global  Addressbook.  Thus,  users  will  not be able to send e-mail to this group
           anymore, and also will not be able to set access rights on folders  for  this  group.  Administrators
           will still be able to see and use the group.

           Default: no

       hide_system
           If  this option is set to 'yes', the internal user SYSTEM will be hidden from the Global Addressbook.
           Thus, users will not be able to send e-mail to this user anymore. Administrators will still  be  able
           to see and use the user.

           Default: yes

       allocator_library
           This  setting  allows one to preload a special library (such as an allocator). On startup, the server
           will set the LD_PRELOAD environment variable for itself and then re-execute itself to get  it  loaded
           with  high  priority.  If this option is empty, the default system allocator (from libc) will be used
           instead, which is probably a better choice when debugging  with  gdb,  valgrind  or  ASAN/UBSAN.  The
           environment variable KC_ALLOCATOR_DONE may also be set to a non-empty value to disable re-exec.

           Default: libtcmalloc_minimal.so.4

EXPLANATION OF THE LOGGING SETTINGS PARAMETERS

       log_method
           The method which should be used for logging. Valid values are:

           syslog
               Use  the  Linux  system  log.  All  messages  will  be  written  to  the  mail facility. See also
               syslog.conf(5).

           file
               Log to a file. The filename will be specified in log_file.

           Default: file

       log_file
           When logging to a file, specify the filename in this parameter. Use - (minus sign) for stderr output.

           Default: /var/log/kopano/server.log

       log_level
           The level of output for logging in the range from 0 to 5. 0 means no logging, 5 means full logging.

           Default: 2

           Extended logging per component is available for development and  can  be  combined  to  log  multiple
           components at the same time.
           ┌────────────┬────────────┐
           │ Component  │   Value    │
           ├────────────┼────────────┤
           │    SQL     │ 0x00010000 │
           ├────────────┼────────────┤
           │ USERPLUGIN │ 0x00020000 │
           ├────────────┼────────────┤
           │   CACHE    │ 0x00040000 │
           ├────────────┼────────────┤
           │ USERCACHE  │ 0x00080000 │
           ├────────────┼────────────┤
           │    SOAP    │ 0x00100000 │
           ├────────────┼────────────┤
           │    ICS     │ 0x00200000 │
           └────────────┴────────────┘

       log_timestamp
           Specify whether to prefix each log line with a timestamp in 'file' logging mode.

           Default: 1

       log_buffer_size
           Buffer logging in what sized blocks. The special value 0 selects line buffering.

           Default: 0

EXPLANATION OF THE SECURITY LOGGING SETTINGS PARAMETERS

       audit_log_enabled
           Whether the security logging feature should be enabled.

           Default: no

       audit_log_method
           The method which should be used for logging. Valid values are:

           syslog
               Use  the  Linux  system  log.  All  messages  will  be written to the authpriv facility. See also
               syslog.conf(5).

           file
               Log to a file. The filename will be specified in log_file.

           Default: syslog

       audit_log_file
           When logging to a file, specify the filename in this parameter. Use - (minus sign) for stderr output.

           Default: -

       audit_log_level
           The level of output for logging in the range from 0 to 1. 0 means no logging, 1 means full logging.

           Default: 1

       audit_log_timestamp
           Specify whether to prefix each log line with a timestamp in 'file' logging mode.

           Default: 1

EXPLANATION OF THE MYSQL SETTINGS PARAMETERS

       mysql_host
           The hostname of the MySQL server to use.

           Default: localhost

       mysql_port
           The port of the MySQL server to use.

           Default: 3306

       mysql_user
           The user under which we connect with MySQL.

           Default: root

       mysql_password
           The password to use for MySQL. Leave empty for no password.

           Default:

       mysql_socket
           The socket of the MySQL server to use. This option can be used to override the default mysql  socket.
           To use the socket, the mysql_host value must be empty or 'localhost'

           Default:

       mysql_database
           The MySQL database to connect to.

           Default: kopano

       mysql_group_concat_max_len
           The  group_concat_max_len  used to set for MySQL. If you have large distribution lists (more than 150
           members), it is useful to set this value higher. On the other hand, some MySQL versions are known  to
           break with a value higher than 21844.

           Default: 21844

       attachment_storage
           The  location  where attachments are stored. This can be in the MySQL database, or as separate files.
           The drawback of 'database' is that the large data of attachment will push useful data from the  MySQL
           cache. The drawback of separate files is that a mysqldump is not enough for a full disaster recovery.

           Default: files

       attachment_path
           When  the  attachment_storage  option is 'files', this option sets the location of the attachments on
           disk. Note that the server runs as the  'run_as_user'  user  and  'run_as_group'  group,  which  will
           require write access to this directory.

           Default: /var/lib/kopano/attachments

       attachment_compression
           When  the  attachment_storage  option  is 'files', this option controls the compression level for the
           attachments. Higher compression levels will compress data better, but at the cost of CPU usage. Lower
           compression levels will require less CPU but will compress data less. Setting the  compression  level
           to 0 will effectively disable compression completely.

           Changing  the compression level, or switching it on or off, will not affect any existing attachments,
           and will remain accessible as normal.

           Set to 0 to disable compression completely. The maximum compression level is 9

           Default: 6

EXPLANATION OF THE SSL SETTINGS PARAMETERS

       server_listen_tls
              A space-separated list of address:port specifiers for where  the  server  should  listen  for  TLS
              connections,  similar  to  the server_listen directive. The default value is empty, which means no
              ports will be listened on for TLS. When this option is used, you must  set  the  SSL  key  options
              correctly, otherwise the server not start.

       server_ssl_enabled, server_ssl_port
              These  historic  directive  specify  the  single port to bind to for SSL connections. Their use is
              discouraged in favor of server_listen_tls. The address is mandated by server_bind.

       server_ssl_key_file
           The file containing the private key and certificate. Please read  the  SSL  section  in  the  kopano-
           server(8) manual on how to create this file.

           Default: /etc/kopano/ssl/server.pem

       server_ssl_key_pass
           Enter your password here when your key file contains a password to be readable.

           No default set.

       server_ssl_ca_file
           The  CA file which was used to sign client SSL certificates. This CA will be trusted. This value must
           be set for clients to login with an SSL Key. Their public key must be  present  in  the  sslkeys_path
           directory.

           No default set.

       server_ssl_ca_path
           When you have multiple CA's to trust, you may use this option. Set this to a directory which contains
           all  your  trusted  CA  certificates.  The  name  of  the  certificate  needs  to  be the hash of the
           certificate. You can get the hash value of the certificate with the following command:

            openssl x509 -hash -noout -in cacert.pem

           Create a symbolic link to the certificate with the hashname like this:

            ln -s cacert.pem `openssl x509 -hash -noout -in cacert.pem`.0

           If you have several certificates which result in the same hash, use .1, .2, etc. in the  end  of  the
           filename.

           No default set.

       sslkeys_path
           The  path which contains public keys of clients which can login over SSL using their key. Please read
           the SSL section in the kopano-server(8) manual on how to create these files.

           Default: /etc/kopano/sslkeys

       server_ssl_protocols
           Disabled or enabled protocol names. Supported protocol names are  SSLv3  and  TLSv1.  If  Kopano  was
           linked  against  OpenSSL 1.0.1 or later there is additional support for the new protocols TLSv1.1 and
           TLSv1.2. To exclude both SSLv3 and TLSv1, set server_ssl_protocols to !SSLv3 !TLSv1.

           Default: SSLv2 being disabled

       server_ssl_ciphers
           SSL ciphers to use, set to ALL for backward compatibility.

           Default: ALL:!LOW:!SSLv2:!EXP:!aNULL

       server_ssl_prefer_server_ciphers
           Prefer the server's order of SSL ciphers over client's.

           Default: no

EXPLANATION OF THE THREADING PARAMETERS

       threads
           Number of server threads.

           Default: 8

       watchdog_frequency
           Watchdog frequency. The number of watchdog checks per second.

           Default: 1

       watchdog_max_age
           Watchdog max age. The maximum age in ms of a task before a new thread is started.

           Default: 500

       server_recv_timeout
           SOAP recv timeout value.

           Default: 5

       server_send_timeout
           SOAP send timeout value.

           Default: 60

EXPLANATION OF THE OTHER SETTINGS PARAMETERS

       softdelete_lifetime
           Softdelete clean cycle, in days. 0 means never. Items older than this setting will  be  removed  from
           the database.

           Default: 0

       sync_lifetime
           Synchronization clean cycle, in days. 0 means never. Synchronizations older than this setting will be
           removed from the database.

           Default: 90

       enable_sso
           When  you configured your system for single sign-on, you can enable this by setting the value to yes.
           The server can autodetect between NTLM and Kerberos.  For  NTLM  authentication  you  will  need  the
           ntlm_auth  program  from Samba. Please see the server installation manual on howto enable your system
           for single sign-on.

           Default: no

       enable_gab
           Enables viewing of the Global Address Book (GAB) by users. Disabling the GAB will show an empty  list
           in the GAB, which may be required for some installations. Resolving addresses is not affected by this
           option.

           Users  with  administrator  rights are also not affected by this option and always have access to the
           GAB.

           Default: yes

       auth_method
           Authentication is normally done in the user plugin, selectable with auth_method=plugin. In case  your
           plugin  cannot  provide  the  authentication,  you  may set this to "pam", and set the pam_service to
           authenticate through pam. Another choice is "kerberos". The user password will be verified using  the
           Kerberos  service.  Note  that  is  not  a  single-signon  method, since the server requires the user
           password.

           Default: plugin

       restrict_admin_permissions
           Normally, admin users are granted all permissions on all stores in the server, or for stores  in  the
           tenant's  company  (in  multi-tenant  mode).  Enabling  this  option  restricts permissions to folder
           operations: Folder viewing, folder creation and importantly, folder permissions. This means  that  an
           administrator  can grant himself full permissions on a folder. However, in combination with auditing,
           it provides an extra level of security protection against unwanted access.

           Note that some applications may require full access to all stores, which would be restricted by  this
           option.  Also,  this  option  cannot  be  reset  by sending a HUP signal, so a full server restart is
           required to change the setting.

           Default: no

       embedded_attachment_limit
           Defines  the  number  of  attachment-in-attachment-in-attachment  levels  allowed  when  saving   and
           replicating  a  MAPI  object.  This  limit can be made higher if needed, but will also require you to
           increase the stack_size in mysql to allow for correct exporting for replication.

           Default: no

       pam_service
           This is the PAM service name. PAM services can be found in /etc/pam.d/.  When choosing a PAM  service
           which  is  configured to use a plugin - such as pam_unix - doing direct file I/O to e.g. /etc/shadow,
           kopano-server will need to be run with a suitable run_as_group/run_as_user values or  otherwise  have
           read permissions.

           Default: passwd

       max_deferred_records
           The  server  has  a  list  of  deferred  writes  to  the  tproperties  table,  to improve overall I/O
           performance. The number of deferred writes is kept below this  value;  setting  it  high  will  allow
           writes  to be more efficient by grouping more writes together, but may slow down reading, and setting
           it low will force writes to complete directly, but speed up reading of tables.

           Default: 0 (off)

       max_deferred_records_folder
           Same as the max_deferred_records variable, but per folder instead of total.

           Default: 20

       disabled_features
           In this list you can disable certain features for users. Normally all features are  enabled  for  all
           users, making it possible through the user plugin to disable specific features for specific users. To
           set  the  default  of  a feature to disabled, add it here to the list, making it possible through the
           user plugin to enable a specific user for specific users.

           This list is space separated, and currently may contain the following features: imap, pop3.

           Default: imap pop3

EXPLANATION OF THE CACHE SETTINGS PARAMETERS

       cache_cell_size
           Size in bytes of the cell cache. This is the main cache used in Kopano. It caches all data that comes
           into view in tables (ie the view of your inbox, or any other folder).  In  an  ideal  situation,  all
           cells  would  be  cached,  so  that  the  database does not need to be queried for data when browsing
           through folders, but this would require around 1.5K per message item (e-mail, appointment task,  etc)
           in  the  entire  server.  If you can afford it, set this value as high as possible, up to 50% of your
           total RAM capacity. Make sure this doesn't lead to swapping though. This value may contain a k, m  or
           g multiplier.

           Default: 256M

       cache_object_size
           This  caches  objects  and  their  respective hierarchy of folders. You can calculate the size with a
           simple equation:

           concurrent users * max items in a folder * 24

           This value may contain a k, m or g multiplier.

           Default: 5M

       cache_indexedobject_size
           This cache contains unique IDs of objects. This cache is used twice, also by the index2 cache,  which
           is the inverse of the index1 cache. This value may contain a k, m or g multiplier.

           Default: 16M

       cache_quota_size
           This cache contains quota values of users. This value may contain a k, m or g multiplier.

           Default: 1M

       cache_quota_lifetime
           This  sets  the  lifetime for quota details inside the cache. If quota details weren't queried during
           this period it is removed from the cache making room for more often requested quota details. Set to 0
           to never expire, or -1 to disable this cache.

           Default: 1 (1 minute)

       cache_acl_size
           This cache contains Access Control List values. Folders who are opened in other stores than your  own
           are listed in the ACL table, and will be cached. This value may contain a k, m or g multiplier.

           Default: 1M

       cache_store_size
           This cache contains store id values. This value may contain a k, m or g multiplier.

           Default: 1M

       cache_user_size
           This  cache  contains  user id values. This cache is used twice, also by the externid cache, which is
           the inverse of this cache. This value may contain a k, m or g multiplier.

           Default: 1M

       cache_userdetails_size
           This cache contains the details of users. This value may contain a k, m or g multiplier.

           Default: 3M

       cache_userdetails_lifetime
           This sets the lifetime for user details inside the cache. If user details weren't queried during this
           period it is removed from the cache making room for more often requested user details. Set  to  0  to
           never expire, or -1 to disable this cache.

           Default: 0 (never expire)

       cache_server_size
           This  cache  contains  server  locations. This cache is only used in multiserver mode. This value may
           contain a k, m or g multiplier.

           Default: 1M

       cache_server_lifetime
           This sets the lifetime for server location details  inside  the  cache.  If  server  details  weren't
           queried  during  this period it is removed from the cache making room for more often requested server
           details. Set to 0 to never expire, or -1 to disable this cache.

           Default: 30 (30 minutes)

EXPLANATION OF THE QUOTA SETTINGS PARAMETERS

       quota_warn
           Size in Mb of de default quota warning level. Use 0 to disable this quota level.

           Default: 0

       quota_soft
           Size in Mb of de default quota soft level. Use 0 to disable this quota level.

           Default: 0

       quota_hard
           Size in Mb of de default quota hard level. Use 0 to disable this quota level.

           Default: 0

       companyquota_warn
           Size in Mb of de default quota warning level for multitenant public stores. Use  0  to  disable  this
           quota level.

           Default: 0

EXPLANATION OF THE USER PLUGIN SETTINGS PARAMETERS

       user_plugin
           The source of the user base. Possible values are:

           db
               Retrieve  the  users  from  the  Kopano  database.  Use the kopano-admin tool to create users and
               groups. There are no additional settings for this plugin.

           ldap
               Retrieve the users and groups information from an LDAP server. All additional LDAP  settings  are
               set  in a separate config file, which will be defined by the user_plugin_config. See also kopano-
               ldap.cfg(5).

           unix
               Retrieve the users and groups information from the Linux password files. User information will be
               read the /etc/passwd file. Passwords will be checked against /etc/shadow. Group information  will
               read from /etc/group. Use the kopano-admin(8) tool to set Kopano specific attributes on a user.

               All  additional  Unix  settings  are  set in a separate config file, which will be defined by the
               user_plugin_config. See also kopano-unix.cfg(5)

           Default: db

       createuser_script,  deleteuser_script,  creategroup_script,   deletegroup_script,   createcompany_script,
       deletecompany_script
           These  scripts  are  called by the server when the external user source, like LDAP, is different from
           the users, groups and companies which are known to Kopano. The script uses a environment variable  to
           see which user, group or tenant is affected. The following parameter is used for the script:

           createuser_script
               KOPANO_USER   contains   the   new  username.  The  script  should  at  least  call  kopano-admin
               --create-store "${KOPANO_USER}" to correctly create the store for the new user.

               Default: /etc/kopano/userscripts/createuser

           deleteuser_script
               KOPANO_STOREID contains the old id of the store of the removed user.

               Default: /etc/kopano/userscripts/deleteuser

           creategroup_script
               KOPANO_GROUP contains the new groupname. No action is currently needed by the script.

               Default: /etc/kopano/userscripts/creategroup

           deletegroup_script
               KOPANO_GROUPID contains the old id of the group. No action is currently needed by the script.

               Default: /etc/kopano/userscripts/deletegroup

           createcompany_script
               KOPANO_COMPANY contains the new companyname. No action is currently needed by the script.

               Default: /etc/kopano/userscripts/createcompany

           deletecompany_script
               KOPANO_COMPANYID contains the old id of the company. No action is currently needed by the script.

               Default: /etc/kopano/userscripts/deletecompany

       user_safe_mode
           If enabled, the storage server will only log when create, delete and move actions are done on an user
           object. This might be useful when you are testing changes to your plugin configuration.

           Default: no

EXPLANATION OF S3 PARAMETERS

       attachment_s3_hostname
           The hostname of the entry point to the S3 cloud where the bucket is located.

           If you are using minio or another S3 compatible implementation that is using another  port,  you  can
           specify the port with hostname:port.

       attachment_s3_region
           The region where the bucket is located

       attachment_s3_protocol
           The protocol that should be used to connect to S3, "http" or "https" (preferred).

       attachment_s3_uristyle
           The URL style of the bucket, "virtualhost" or "path".

       attachment_s3_accesskeyid
           The access key id of your S3 account.

       attachment_s3_secretaccesskey
           The secret access key of your S3 account.

       attachment_s3_bucketname
           The bucket name in which the files will be stored.

EXPLANATION OF MISCELLEANIOUS PARAMETERS

       enable_hosted_kopano
           Enable multi-tenancy environment.

           When  set  to true it is possible to create companies within the kopano instance and assign all users
           and groups to particular companies.

           When set to false, the normal single-tenancy environment is created.

           Default: false

       enable_distributed_kopano
           Enable multi-server environment.

           When set to true it is possible to place users and companies on specific servers.

           When set to false, the normal single-server environment is created.

           Default: false

       storename_format
           Display format of store name.

           Allowed variables:

           %u
               Username

           %f
               Fullname

           %c
               Companyname

           Default: %f

       loginname_format
           Loginname format  (for  multi-tenancy  installations).  When  the  user  does  not  login  through  a
           system-wide  unique  username  (like  the  email  address) a unique name has created by combining the
           username and the tenancyname. With the this configuration option you can set how the loginname should
           be build up.

           Allowed variables:

           %u
               Username

           %c
               Companyname

           Default: %u

       client_update_enabled
           Enable client updates.

           You can place the Kopano Outlook Client installer in the  client_update_path  directory,  and  enable
           this  option.  Windows  clients  which  have  the automatic updater program installed will be able to
           download the latest client from the storage server.

           Default: false

       client_update_path
           This is the path where you will place the Kopano Outlook  Client  MSI  install  program  for  Windows
           clients  to  download.  You need the client_update_enabled option set to true for clients to actually
           download this file through the storage server.

           Default: /var/lib/kopano/client

       client_update_log_level
           Receive the log information from the client auto update service.

           Options: 0 disable, 1 sent only with errors, 2 always sent

           Default: 1

       client_update_log_path
           Log location for the client auto update files

           You need the client_update_log_level option set to non-zero value  to  receive  log  files  from  the
           client.

           Default: /var/log/kopano/autoupdate

       search_enabled
           Use  the  kopano-search  indexing  service  for  faster  searching. Enabling this option requires the
           kopano-search(8) service to be running.

           Default: yes

       search_socket
           Path to the kopano-search(8) service, this option is only required if the server is going to make use
           of the indexing service.

           Default: file:///var/run/kopano/search.sock

       search_timeout
           Time (in seconds) to wait for a connection to the kopano-search(8)  before  terminating  the  indexed
           search request.

           Default: 10

       enable_enhanced_ics
           Allow  enhanced  ICS  operations  to  speedup synchronization with cached profiles. Only disable this
           option for debugging purposes.

           Default: yes

       enable_sql_procedures
           SQL Procedures allow for some optimized queries when streaming with enhanced  ICS.  This  is  default
           disabled  because  you  must set 'thread_stack = 256k' in your MySQL server config under the [mysqld]
           tag and restart your MySQL server.

           Default: no

       folder_max_items
           Limits the amount of items (messages or folders) in a single folder. This makes sure that the  server
           will  not attempt to load folders that are so large that it would require huge amounts of memory just
           to show the data. In practice, folders of over 1000000 items are usually created by runaway processes
           which are therefore useless anyway.

           Default: 1000000

       sync_gab_realtime
           When set to 'yes', kopano will synchronize the local user list whenever a list of users is  requested
           (eg  during  kopano-admin  -l  or  when  opening  the  addressbook). When setting this value to 'no',
           synchronization will only occur during kopano-admin --sync. This is  useful  for  setups  which  have
           large addressbooks (more than 1000 entries in the addressbook).

           This  option  is forced to 'yes' when using the 'db' plugin since synchronization is implicit in that
           case.

           Default: yes

       proxy_header
           In normal operation, a cluster of kopano-server nodes is served by sending redirections back  to  the
           clients  requesting  information.  The  redirection URL is built from the server's information in the
           LDAP database. However, in some cases it is useful to place  the  kopano-server  instances  behind  a
           reverse  HTTP  proxy.  In  this case the redirected URL returned to the client cannot be the 'normal'
           hostname, but must be a URL that is handled by the proxy.

           However, internal ('behind' the proxy) redirections must *not* be redirected to the proxy since  this
           is not necessary. The strategy is that kopano-server will redirect to the proxy URL if the connection
           that  initiated the redirect passed through a proxy. The way that this is detected is by examining an
           HTTP header. If the header specified by this option is found, then redirections will be to the proxy.
           If it is not, then redirections will be to the internal host. If the special value '*'  is  specified
           for  this  option,  then  the proxy URL will always be used. Specifying an empty value disables proxy
           detection.

           Another effect of this option is that when a proxy connection is detected, kopano-server attempts  to
           use  the  'X-Forwarded-For'  header to determine the originating IP address. This is used for logging
           and session binding (a session initiated on a certain IP address may not be accessed from another  IP
           address).

           Default:

       shared_reminders
           Enable/disable reminders for shared stores.

           Default: yes

RELOADING

       The  following  options  are  reloadable  by sending the kopano-server process a HUP signal or reload the
       process by the initscript

       system_email_address,  local_admin_users,  allow_local_users,  hide_system,  hide_everyone,  auth_method,
       pam_service, enable_sso, enable_gab, sync_gab_realtime

       session_timeout, server_recv_timeout, server_read_timeout, server_send_timeout, sync_lifetime

       log_level, audit_log_level

       threads, watchdog_max_age, watchdog_frequency, max_deferred_records, max_deferred_records_folder

       user_safe_mode, enable_enhanced_ics, client_update_log_level, client_update_path, client_update_log_path

       search_enabled,    search_socket,    search_timeout,    disabled_features,    mysql_group_concat_max_len,
       embedded_attachment_limit, proxy_header

       quota_warn, quota_soft, quota_hard, companyquota_warn

       createuser_script,  deleteuser_script,  creategroup_script,   deletegroup_script,   createcompany_script,
       deletecompany_script

FILES

       /etc/kopano/server.cfg
           The server configuration file.

       /etc/kopano/ldap.cfg
           The Kopano LDAP user plugin configuration file.

       /etc/kopano/unix.cfg
           The Kopano Unix user plugin configuration file.

AUTHOR

       Written by Kopano.

SEE ALSO

       kopano-server(8), kopano-ldap.cfg(5), kopano-unix.cfg(5)

Kopano 8                                          November 2016                             KOPANO-SERVER.CFG(5)