daniellerch/korga repository overview

⁠Korga

Korga stands for the german term Kirchen Organisation (church organization). It synchronizes people and groups with ChurchTools⁠ and provides specialized features like email distribution lists.

⁠What can Korga already do?

⁠Email distribution lists

Once configured, Korga automatically synchronizes people and groups from ChurchTools. This data can be used to create distribution lists. There is no Web UI available yet to manage distribution lists so you must stick to the CLI inside the Docker container:

./Korga dist create kids
./Korga dist add-recipient kids -g 137

This command creates a distribution list [email protected]⁠ which forwards emails to every member of group #137.

⁠Installation

The only officially supported distribution are Docker containers. An official image is available at daniellerch/korga⁠. If you are using Docker Compose, take a look our example compose file⁠ in the docs folder.

Korga has multiple modules that must be enabled via configuration to use them:

• ChurchTools sync
• Email delivery
• Email relay

Configuration can set as enviroment variables or by creating a custom config file. I recommend to use environment variables and will explain them in the following sections. However, if you prefer a config file, copy the default appsettings.json⁠, edit it as required, and mount it at /app/appsettings.json.