Skip to content

Latest commit

 

History

History
32 lines (20 loc) · 2.34 KB

README.md

File metadata and controls

32 lines (20 loc) · 2.34 KB

OpenKool

This application is a dockerized version of kOOL form churchtool.org.

Legacy Software

⚠️ If you have never heard about kOOL, do not use it! ⚠️

With PHP 7.4 having reached its end of life on 28 November 2022, OpenKool does not receive security fixes to its underlying Docker images anymore. Supporting more recent PHP versions, however, is difficult: #25

kOOL is probably the most advanced open source organization software for small churches available today. Unfortunately, it is built on old software and never had a good architecture. Improving this, however, would result in thousands of merge conflicts for every new upstream version. That is why OpenKool just aims to keep kOOL operational for next the years until there are better alternatives available.

Installation

The recommended deployment option for OpenKool is to use Docker containers. An official image is available at daniellerch/openkool:r48.

You can install OpenKool from scratch or take over your database from an existing kOOL instance. Please read the installation guide for more information.

Upgrading

All major upgrades have to be performed manually as they usually ship with breaking changes which require special attention. Read the changelogs at OpenKool's releases page carefully.

You cannot skip major upgrades. If you want to upgrade from R45 to R48 for example you have to migrate to R46, R47 and finally to R48. Please refer to the docs folder for upgrade instructions.

Contributing

Contributions are very welcome. Please open an issue to discuss your wishes before implementing them. For a development environment you will need PHP, XDebug and Visual Studio Code with PHP Intelephense and PHP Debug extensions. On Windows you will find install/devenv.ps1 very useful and may use psmodules to install a suitable database server.