mirror of
https://github.com/zokradonh/kopano-docker
synced 2025-06-07 07:56:12 +00:00
bcb0926c6d
* fixes for setup-tools.sh fixes https://github.com/zokradonh/kopano-docker/issues/266 * add startup tests for meet demo * add architecture to contributing file * define ical_listen for kopano-ical * precreate database if it does not yet exist * fix spelling
51 lines
2.8 KiB
Markdown
51 lines
2.8 KiB
Markdown
# Kopano Core image
|
||
|
||
[](https://microbadger.com/images/zokradonh/kopano_core "Microbadger size/labels") [](https://microbadger.com/images/zokradonh/kopano_core "Microbadger version")
|
||
|
||
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.
|
||
|
||
```bash
|
||
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-cli --list-users` could be run once after initial install in the kopano_server container.
|
||
|
||
Example:
|
||
|
||
`docker-compose exec kopano_server kopano-cli --list-users`
|
||
|
||
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).
|