# Release OP-20720 - 17.8.2 Release OpenProject

Project: OpenProject
Status: in progress
URL: https://community.openproject.org/work_packages/OP-20720

## Details

| Attribute | Value |
| --- | --- |
| Date | 2026-11-09 |
| Release Type | Patch Release |
| Target versions | 17.8.2 |

## People

| Attribute | Value |
| --- | --- |
| Assignee | OP Devops Team |
| Accountable |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work |  |
| Remaining work |  |

## Description

**Prerequisites**

  - Clone and install <https://github.com/opf/openproject-devkit>

  - Set up and authorize <https://cli.github.com/> with a `repo` scope token with access to the openproject, release-api and openproject-website repositories. This is used for:
    
      - automatic triggering of the website documentation build
    
      - automatic publishing of the release entry on GitHub

  - Create an access token for the OpenProject community, and export that using `export OPENPROJECT_API_TOKEN="token"`. This is used for:
    
      - This is used for automatic creation of the release news

**Releasing**

Creating a new release boils down to running `bin/opdev release 17.8.2`, which does the following:

  - Create a `workspace/` directory where openproject core and release api are cloned. Then the following release actions are done locally:
    
      - Release core stable/17 from release/17.8
    
      - Tag stable/17 with v17.8.2
    
      - Bump release/17.8 to 17.8.(Z+1)
    
      - Create a release-api entry
    
      - Creating and publishing release notes (if not already present)

So, to actually run this command to release OpenProject@v17.8.2 you use:

`./bin/opdev release 17.8.2`

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 17.8.2`

**Release Checklist**

  - Confirm release got added correctly to <https://github.com/opf/openproject/releases>

  - Confirm release got added as news to <https://community.openproject.org/projects/openproject>

  - Confirmed docker tags built at <https://github.com/opf/openproject/actions/workflows/docker-release.yml?query=>

  - Confirmed packages completed at <https://github.com/opf/openproject/actions/workflows/packager.yml>

  - Confirmed Helm chart PR (created automatically once the step above is finished) is green and merged (<https://github.com/opf/helm-charts/pulls>)

  - MAJOR VERSIONS ONLY: Updated tag in docker-compose.yml <https://github.com/opf/openproject-deploy/blob/stable/11/compose/docker-compose.yml#L14>