# Task OP-17636 - Update OpenProject image in openDesk

Project: OpenProject
Status: closed
URL: https://community.openproject.org/work_packages/OP-17636

## Details

| Attribute | Value |
| --- | --- |
| Assignee | Jens Ulferts |
| Date |  – 2025-10-09 |
| Priority | Medium |
| Target versions | 16.5.0 |
| Category |  |
| Labels |  |

## Description

**Building the openDesk flavour**

  - After the release has been created with the devkit, the stable build will have triggered
    
      - Observe the output at <https://github.com/opf/openproject-flavours/actions/workflows/ci-stable.yml>
    
      - If for some reason, this trigger failed, use the "Run workflow" with the Core Ref "stable/X" (where X is the current major release version, e.g., 15)

  - Wait for the ci-stable workflow to run through to push `openproject/open_desk:X.Y.Z`
    
      - You can see the pushed images here: <https://hub.docker.com/r/openproject/open_desk/tags>
    
      - Click on built image for the version X.Y.Z, then copy the SHA from the top , e.g., <https://hub.docker.com/layers/openproject/open_desk/15.3.2/images/sha256-5558a9164dfeb839b3d2b9ea97368473a50255931fd623d579b7858360f52c0c>
    
      - 
        
        <img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/751093/content">

**Updating openDesk at opencode**

<br>

  - opencode will automatically find new upstream updates regularly, so just make sure the above image has been pushed correctly.

  - You can also ensure the update happens quickly by taking these manual steps
    
      - You need to submit a PR to the openDesk repository at opencode: <https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk>
    
      - Edit these files:
        
          - The OpenProject docker image: <https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk/-/blob/develop/helmfile/environments/default/images.yaml.gotmpl?ref_type=heads>  
            Change the tag using the copied value from the docker hub above to `tag: "X.Y.Z@sha256:5558a9.....c0c"` (for example: `tag: "15.3.2@sha256:5558a9164dfeb839b3d2b9ea97368473a50255931fd623d579b7858360f52c0c"`)
        
          - Change the README to point to the most recent version in OpenProject: <https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk/-/blob/develop/README.md?ref_type=heads#overview>
    
      - Follow [branch name conventions](https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk/-/blob/develop/docs/developer/workflow.md#branch-names) and [commit message conventions](https://gitlab.opencode.de/bmi/opendesk/deployment/opendesk/-/blob/develop/docs/developer/workflow.md#commit-messages--conventional-commits) from the repository. Branch name like `feat/openproject/bump-X-Y-Z`. Commit message like `feat(openproject): Update from 16.0.0 to 16.0.1`. Branch off from the `develop` branch.
    
      - Add a label using the autocompleter below the input, by searching for "openproject"
    
      - Assign reviewer to Thorsten Roßner
    
      - Press create merge request and wait for replies

  - Leave this ticket open and assign it to "opendesk opencode reviewer" placeholder user, to signal that we're waiting for them

**Create release work package in openDesk family**

  - Open this query, update or add the Release work package for the current version, <https://project.opendesk.family/projects/openproject/work_packages?query_id=892> (for example, <https://project.opendesk.family/projects/openproject/work\_packages/1062/activity?query\_id=892>)
