Skip to content

The Release Process

George Dawoud edited this page Nov 18, 2025 · 8 revisions

The Release Process

This is the current, simplified release process for ChurchCRM. The process uses automated builds from GitHub Actions and creates releases directly from tested master branch builds.

Steps

  1. Verify Clean Build: Confirm that the master branch has a clean build - https://github.com/ChurchCRM/CRM/actions/workflows/build-test-package.yml?query=branch%3Amaster

  2. Download Artifact: Download the artifact from the latest successful clean build.

    image

  3. Extract Release File: Unzip ChurchCRM.x.y.z-files and confirm the presence of a .zip file.

    image

  4. Create GitHub Release: Start a new release on GitHub by visiting https://github.com/ChurchCRM/CRM/releases/new

  5. Select Commit: Ensure to select the same commit ID for the release as the one from the downloaded build above.

  6. Generate Release Notes: Automatically generate release notes using the provided Generate release notes functionality.

    image

  7. Upload Zip File: Upload the .zip file to the release.

  8. Publish Release: Complete the release process on GitHub.

  9. Close Milestone: Close the previous milestone by visiting https://github.com/ChurchCRM/CRM/milestones.


Note: This is the current release process. Legacy release procedures have been archived.

Clone this wiki locally