Skip to main content

Upgrade from DSF 2.0.0

DSF-Team11/26/25About 1 min

DSF 2.0.1

This is one of the first released versions of the Data Sharing Framework (DSF) 2.0.
Please do not use this version in production environments.

We kindly invite all DSF administrators to test this release on their staging or test instances and share their feedback with us through the usual communication channels.

Thank you for helping us improve the DSF!

Upgrading the DSF from 2.0.0 to 2.0.1 involves modifying the image versions in the docker-compose.yml files and recreating the containers.

DSF 2 was designed to run DSF 1 (APIv1) process plugins, but due to stricter validation rules in DSF 2 we strongly recommend using the latest compatible plugin versions. Updates within the same major and minor version (e.g., from 1.2.3.4 to 1.2.9.9) are generally safe. An overview of the recommended MII/NUM versions can be found here.

Modify DSF FHIR Server Setup

  1. Preparation / Backup

    • We recommend to create a backup of the /opt/fhir directory before proceeding with the upgrade.
      For example using: sudo cp -rp /opt/fhir /opt/fhir_backup_pre_2.0.1_upgrade

  2. Modify the DSF FHIR docker-compose.yml file, replace the version number with 2.0.1.

 version: '3.8'
 services:
   proxy:
-    image: ghcr.io/datasharingframework/fhir_proxy:2.0.0
+    image: ghcr.io/datasharingframework/fhir_proxy:2.0.1
     restart: on-failure
...
   app:
-    image: ghcr.io/datasharingframework/fhir:2.0.0
+    image: ghcr.io/datasharingframework/fhir:2.0.1
     restart: on-failure
...
  1. Upgrade the DSF FHIR containers
    From /opt/fhir execute
    docker compose up -d && docker compose logs -f

Modify DSF BPE Server Setup

  1. Preparation / Backup

    • We recommend to create a backup of the /opt/bpe directory before proceeding with the upgrade.
      For example using: sudo cp -rp /opt/bpe /opt/bpe_backup_pre_2.0.1_upgrade

  2. Modify the DSF BPE docker-compose.yml file, replace the version number with 2.0.1.

 version: '3.8'
 services:
   app:
-    image: ghcr.io/datasharingframework/bpe:2.0.0
+    image: ghcr.io/datasharingframework/bpe:2.0.1
     restart: on-failure
...

  1. Upgrade the DSF BPE containers
    From /opt/bpe execute

    docker compose up -d && docker compose logs -f

  2. Verify your upgrade:

    • Verify the DSF FHIR server is running in version 2.0.0. The log should contain a message:
      INFO main - BuildInfoReaderImpl.logBuildInfo(137) | Artifact: dsf-fhir-server-jetty, version: 2.0.1, [...]
    • Verify the DSF FHIR server started without errors
    • Verify the DSF FHIR server is accessible via https, for example by browsing to https://your-dsf-endpoint.de/fhir/ (authentication with your client-certificate)
    • Verify the DSF BPE server is running in version 2.0.0. The log should contain a message:
      INFO main - BuildInfoReaderImpl.logBuildInfo(137) | Artifact: dsf-bpe-server-jetty, version: 2.0.1, [...]
    • Verify the DSF BPE server started without errors
    • Verify your install with a ping/pong test
Last Updated