1
0
mirror of https://github.com/zokradonh/kopano-docker synced 2025-06-07 16:06:14 +00:00
Felix Bartels d514ef44cb
implement new env variable to disable all automatic actions (#434)
* implement new env variable to disable all automatic actions

fixes https://github.com/zokradonh/kopano-docker/issues/360

* wrap the remaining services in checks if autoconfigure/disable_checks is used
* move definition of AUTOCONFIGURE variable into base image
* add logic to kapps and kdav container
* add autoconfigure to konnect container
* update build stage to latest golang
* add autoconfig to remaining images
* delete obsolete apache config in z-push folder
* when specifying config paths use KOPANO_CONFIG_PATH
* also use env variable in helper scripts
* add message about removal of kopano-cli
2020-08-28 09:48:32 +02:00
..
2020-08-24 15:24:04 +02:00
2020-08-24 15:24:04 +02:00

Kopano Core image

Image for components out of the "Kopano Core" repository. Is used to start containers for e.g. kopano-server and kopano-gateway.

E-Mail attachment directory is by default in /kopano/data/attachments/ it is recommended to bind /kopano/data as volume.

Attachment location can be configured by setting the environment variable KCCONF_SERVER_ATTACHMENT_PATH.

All configuration can be adjusted dynamically through environment variables.

KCCONF_SERVER_MYSQL_HOST=127.0.0.1
^      ^     ^   ^
|      |     |   |
General prefix   |
       |     |   |
        Name of the relevant configuration file (server.cfg in this case)
             |   |
             Name of the configuration option in the configuration file
                 |
                 Value of the configuration option

Examples:

  • specify KCCONF_SERVER_MYSQL_HOST for mysql_host setting in server.cfg
  • specify KCCONF_LDAP_LDAP_SEARCH_BASE to set ldap_search_base in ldap.cfg

Additionally it is possible to comment specific options in/out with KCCOMMENT_filenameWithoutExtension_anystring=searchline
e.g. KCCOMMENT_LDAP_1=!include /usr/share/kopano/ldap.openldap.cfg

For core dumps on crashes kopano-server requires the fs.suid_dumpable sysctl to contain the value 2, not 0.

It is recommended to sync the user list before the first login of a user. With the bundled ´docker-compose.yml´ the ´kopano_scheduler´ container will take care of this. Alternatively kopano-admin --sync could be run once after initial install in the kopano_server container.

Example:

docker-compose exec kopano_server kopano-admin -l

Depending on the overall performance of the system and the amount of user the first execution of this command will take a moment before it produces any output. This is since this command kicks off the mailbox creation for the users.

See https://documentation.kopano.io/kopanocore_administrator_manual/configure_kc_components.html#testing-ldap-configuration for more information.

Ports & Proxying

  • kopano-server is configured to listen on the ports 236 (plain) and 237 (https)
  • kopano-ical is configured to listen on the port 8080, but the web container is also configured to proxy access to http(s)://FQDN/caldav to kopano-ical
  • kopano-gateway is configured to listen on IMAP traffic on port 143. Pop3 is deactivated by default but would be listening on port 110. Pop3s and IMAPs are currently not configured. (see https://github.com/zokradonh/kopano-docker/issues/16 for more details).