**Prerequisites**

* Clone and install [https://github.com/opf/openproject-devkit](https://github.com/opf/openproject-devkit)

**Releasing**

Creating a new patch release boils down to running `bin/opdev release X.Y.Z`, which Begin of the insertiondoes the following:End of the insertion Begin of the deletion combines releasing:End of the deletion

* Begin of the insertionCreate a `workspace/` directory where openproject core and release api are cloned. Then the following release actions are done locally::
* End of the insertion Release core stable/X from release/X.Y Begin of the insertion
End of the insertion Begin of the deletion
End of the deletion * Tag stable/X with vX.Y.Z Begin of the insertion
End of the insertion Begin of the deletion
End of the deletion * Bump release/X.Y to X.Y.(Z+1) Begin of the insertion
End of the insertion Begin of the deletion
End of the deletion * Create a release-api entry Begin of the insertion
End of the insertion Begin of the deletion
End of the deletion * Creating and publishing release notes

So, to actually run this command to release OpenProject@vX.Y.Z you use:

`./bin/opdev release X.Y.Z`

Once that command has completed, you can inspect your local workspace to make sure the release is complete and then redo it with push enabled:

`./bin/opdev release --push X.Y.Z`

**Release Checklist**

* [ ] Release added to [https://github.com/opf/openproject/releases](https://github.com/opf/openproject/releases)
* [ ] Release added to https://community.openproject.org/projects/openproject/news/new
* [ ] Confirmed release API up to date [https://releases.openproject.com/v1/check.svg?version=X.Y.Z&type=packager](https://releases.openproject.com/v1/check.svg?version=10.4.0&type=packager)
* [ ] Confirmed packages completed at https://packager.io/gh/opf/openproject/refs/stable/X
* [ ] Confirmed docker tags built at [https://hub.docker.com/r/openproject/community/](https://hub.docker.com/r/openproject/community/)