chore: Release OH 4.6.0

Updating OH from `2.4.0` to `4.6.0`.

Many updates to OH: https://github.com/BLSQ/openhexa-app/releases (Most important: support for Azure storage).

- fix: Run fixtures in "localhosting" mode: This implies that the `DJANGO_SUPERUSER_PASSWORD` must be set.
- fix: Smoke tests
- fix: Add ENV vars to` .env.dist`
- chore: Update OH to `4.6.0` and docker images to `1.17.2`

Author: bramj

.env.dist

@@ -25,6 +25,11 @@ DATABASE_NAME=hexa-app
 DATABASE_USER=hexa-app
 DATABASE_PASSWORD=hexa-app
 
+# Initial Django admin user
+DJANGO_SUPERUSER_USERNAME=root@openhexa.org
+DJANGO_SUPERUSER_EMAIL=root@openhexa.org
+DJANGO_SUPERUSER_PASSWORD=root
+
 # Networking
 ############
 
@@ -89,7 +94,7 @@ PIPELINE_SCHEDULER_SPAWNER=docker
 ############
 
 # The image to run the notebook containers
-JUPYTER_IMAGE=blsq/openhexa-base-environment:1.16.0
+JUPYTER_IMAGE=blsq/openhexa-base-environment:1.17.2
 
 # Encryption settings
 JUPYTERHUB_CRYPT_KEY=${JUPYTERHUB_CRYPT_KEY}
@@ -118,11 +123,21 @@ WORKSPACE_BUCKET_PREFIX=hexa-test-
 # Workspace storage options
 # --------------------------
 
-# Local FS: Define the root location where the workspaces files will be stored
+# Storage backend to use for workspace files.
+# Options:
+#   - "fs" (local filesystem)
+#   - "gcp" (Google Cloud Storage)
+#   - "azure" (Azure Blob Storage)
+# Default: fs
+STORAGE_BACKEND=fs
+
+# Local FS (STORAGE_BACKEND=fs): Define the root location where the workspaces files will be stored
 # Absolute path to the directory where the workspaces data will be stored
 WORKSPACE_STORAGE_LOCATION=$WORKSPACE_STORAGE_LOCATION
 
-## GCP: Mandatory to run with GCS
+## GCP (STORAGE_BACKEND=gcp): Google Cloud Storage configuration
+# Base64 encoded service account key JSON (required when STORAGE_BACKEND=gcp)
+# Generate with: base64 -w 0 service-account-key.json
 WORKSPACE_STORAGE_BACKEND_GCS_SERVICE_ACCOUNT_KEY=
 
 # # openssl rand -hex 16
@@ -138,6 +153,11 @@ WORKSPACE_STORAGE_BACKEND_AWS_BUCKET_REGION=
 
 WORKSPACE_BUCKET_REGION=
 
+## Azure (STORAGE_BACKEND=azure): Azure Blob Storage configuration
+# Connection string for Azure Storage account (required when STORAGE_BACKEND=azure)
+# Format: DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>;EndpointSuffix=core.windows.net
+# AZURE_STORAGE_CONNECTION_STRING=
+
 # Datasets
 ###########
 

.github/workflows/build_debian_package.yml

@@ -106,7 +106,7 @@ jobs:
       - name: Install OpenHexa
         run: |
           sudo dpkg -i openhexa_*_amd64.deb
-      
+
       - name: Check OpenHexa status
         run: |
           sudo systemctl status openhexa.service
@@ -126,6 +126,7 @@ jobs:
       - name: Start OpenHexa if run locally
         if: ${{ env.ACT }}
         run: /usr/share/openhexa/openhexa.sh -g start
+
       - name: Get OpenHexa status
         run: /usr/share/openhexa/openhexa.sh -g status
 
@@ -137,8 +138,10 @@ jobs:
       - name: Build smoke tests image
         working-directory: ./smoke-tests
         run: docker build -t openhexa/smoke-tests .
+
       - name: Run smoke tests
         run: docker run -t --net=host -v "$(pwd)/test-results:/code/test-results" openhexa/smoke-tests http://localhost:3000/ root@openhexa.org root
+
       - name: Keep test results
         uses: actions/upload-artifact@v7
         with:
@@ -204,4 +207,4 @@ jobs:
           echo '```bash' >> $GITHUB_STEP_SUMMARY
           echo 'curl -sfLo /etc/apt.trusted.gpg.d/${{ needs.build.outputs.keyring }}.asc ${{ steps.deploy-pages.outputs.page_url }}gpg.key' >> $GITHUB_STEP_SUMMARY
           echo 'echo "deb ${{ steps.deploy-pages.outputs.page_url }} ${{ env.CODENAME }} ${{ env.COMPONENTS }}" >/etc/apt/sources.list.d/${{ env.REPO_NAME }}.list' >> $GITHUB_STEP_SUMMARY
-          echo '```' >> $GITHUB_STEP_SUMMARY                
+          echo '```' >> $GITHUB_STEP_SUMMARY

compose.yml

@@ -3,7 +3,7 @@
 # Do not change it without good reaons.
 
 x-app: &common
-    image: "blsq/openhexa-app:2.4.0"
+    image: "blsq/openhexa-app:4.6.0"
     platform: linux/amd64
     networks:
       - openhexa
@@ -21,7 +21,7 @@ x-app: &common
       # It allows us to run the fixture command
       DEBUG: true
       # The Python module where Django can find its settings
-      DJANGO_SETTINGS_MODULE: config.settings.local
+      DJANGO_SETTINGS_MODULE: config.settings.base
       # The URI to access the Jupyter Hub through the local Docker network
       NOTEBOOKS_HUB_URL: http://jupyterhub:8000/hub
       # The URL passed to the pipelines to access the backend API through the
@@ -32,6 +32,8 @@ x-app: &common
       DATABASE_HOST: db
       WORKSPACES_DATABASE_HOST: db
       WORKSPACES_DATABASE_PROXY_HOST: db
+      # Storage backend for workspace files
+      STORAGE_BACKEND: ${STORAGE_BACKEND:-fs}
       # To control what hostname can access the backend
       ADDITIONAL_ALLOWED_HOSTS: "app,frontend"
 services:
@@ -50,7 +52,7 @@ services:
       retries: 3
 
   frontend:
-    image: "blsq/openhexa-frontend:2.4.0"
+    image: "blsq/openhexa-frontend:4.6.0"
     platform: linux/amd64
     networks:
       - openhexa
@@ -108,7 +110,7 @@ services:
       retries: 3
 
   jupyter:
-    image: ${DEFAULT_WORKSPACE_IMAGE:-blsq/openhexa-base-environment:1.16.0}
+    image: ${DEFAULT_WORKSPACE_IMAGE:-blsq/openhexa-base-environment:1.17.2}
     platform: linux/amd64
     command: echo
     profiles:

debian/changelog

@@ -1,3 +1,11 @@
+openhexa (3.0-1) stable; urgency=medium
+
+  [ Bram Jans ]
+  * Update OpenHEXA to version 4.6.0, docker-images to 1.17.2
+  * Add ENV variables for Azure support
+
+ -- Bram Jans <bjans@bluesquarehub.com>  Mon, 23 Feb 2026 11:36:24 +0200
+
 openhexa (2.0-1.1) stable; urgency=medium
 
   [ Bram Jans ]

script/openhexa.sh

@@ -12,7 +12,7 @@ source "${SCRIPT_DIR}/common_functions.sh"
 function usage() {
   if [[ -z $1 ]]; then
     echo """
-    
+
     Usage:    $0 [OPTIONS] COMMAND
 
     OPTIONS:
@@ -44,7 +44,7 @@ function usage() {
   case $cmd in
   restore)
     echo """
-      
+
     Usage:    restore [OPTIONS]
 
     OPTIONS: none
@@ -287,7 +287,7 @@ function execute() {
     exit_properly 0
     ;;
   prepare)
-    run_compose_with_profiles run app fixtures
+    run_compose_with_profiles run app fixtures --localhosting
     run_compose_with_profiles run jupyterhub jupyterhub upgrade-db -f /etc/jupyterhub/jupyterhub_dev_config.py
     exit_properly 0
     ;;