Support for MATLAB R2026a

rashedmyt · prabhakk-mw · commit d48543ab0dc0 · 2026-04-17T10:00:37.000Z
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
@@ -1,6 +1,6 @@
 {
-    "name": "MATLAB R2025b",
-    "image": "ghcr.io/prabhakk-mw/matlab-integration-for-jupyter/jupyter-matlab-notebook:r2025b",
+    "name": "MATLAB R2026a",
+    "image": "ghcr.io/mathworks-ref-arch/matlab-integration-for-jupyter/jupyter-matlab-notebook:r2026a",
     // Configure VSCode Extensions
     "customizations": {
         "vscode": {
diff --git a/.devcontainer/using-dockerfile/devcontainer.json b/.devcontainer/using-dockerfile/devcontainer.json
@@ -13,7 +13,7 @@
     "build": {
         "dockerfile": "../../Dockerfile",
         "args": {
-            "MATLAB_RELEASE": "r2025b",
+            "MATLAB_RELEASE": "r2026a",
             "MATLAB_PRODUCT_LIST": "MATLAB Symbolic_Math_Toolbox Simulink",
             "MATLAB_INSTALL_STAGE_SELECTOR": "using-mpm"
         }
diff --git a/.github/workflows/build-and-publish-docker-image.yml b/.github/workflows/build-and-publish-docker-image.yml
@@ -1,4 +1,4 @@
-# Copyright 2023 The MathWorks, Inc.
+# Copyright 2023-2026 The MathWorks, Inc.
 
 name: Build and Publish the Container Image
 
@@ -24,7 +24,7 @@ on:
         required: true
         type: string
       os_info_tag:
-        description: 'Allowed values: ubuntu20.04 ubuntu22.04'
+        description: 'Allowed values: ubuntu20.04 ubuntu22.04 ubuntu24.04'
         required: true
         type: string
       is_default_os:
@@ -39,9 +39,12 @@ on:
 jobs:
   build-push-image:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v6
 
       - name : Setup Image Tags
         id: setup_image_tags
@@ -56,25 +59,25 @@ jobs:
       # List is defined as a New Line Separated set of values. See: https://github.com/docker/build-push-action?tab=readme-ov-file#inputs
       - name: Create New Line separated from Comma Separated
         id: convert-build-args-csv-to-list
-        uses: actions/github-script@v7
+        uses: actions/github-script@v9
         with:
           script: |
             core.setOutput('build-args-as-list', `${{ inputs.build_args_csv }}`.split(",").join("\n"))
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v4
         with:
           registry: ghcr.io
           username: ${{ github.repository_owner }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v4
 
       # Example tags: r2023a-ubuntu20.04, R2023a-ubuntu20.04
       - name: Build & Push Image
         if: ${{ inputs.is_default_os == false }}
-        uses: docker/build-push-action@v4
+        uses: docker/build-push-action@v7
         with:
           build-args: |
             ${{ steps.convert-build-args-csv-to-list.outputs.build-args-as-list }}
@@ -88,7 +91,7 @@ jobs:
       # Example tags: r2023a-ubuntu20.04, R2023a-ubuntu20.04, r2023a, R2023a
       - name: Build & Push Image for latest OS
         if: ${{ inputs.is_default_os == true }}
-        uses: docker/build-push-action@v4
+        uses: docker/build-push-action@v7
         with:
           build-args: |
             ${{ steps.convert-build-args-csv-to-list.outputs.build-args-as-list }}
diff --git a/.github/workflows/jupyter-matlab-notebook.yaml b/.github/workflows/jupyter-matlab-notebook.yaml
@@ -1,4 +1,4 @@
-# Copyright 2024-2025 The MathWorks, Inc.
+# Copyright 2024-2026 The MathWorks, Inc.
 # Build & Publish jupyter-matlab-notebook
 name: jupyter-matlab-notebook
 
@@ -20,10 +20,13 @@ on:
 
 jobs:
   build-and-publish-docker-image:
+    permissions:
+      contents: read
+      packages: write
     strategy:
       fail-fast: false
       matrix:
-        matlab_release_tag: [R2025b, R2025a, R2024b, R2024a, R2023b, R2023a, R2022b]
+        matlab_release_tag: [R2026a, R2025b, R2025a, R2024b, R2024a, R2023b, R2023a, R2022b]
     uses: ./.github/workflows/build-and-publish-docker-image.yml
     secrets: inherit
     with:
diff --git a/.github/workflows/jupyter-mounted-matlab-notebook.yml b/.github/workflows/jupyter-mounted-matlab-notebook.yml
@@ -1,4 +1,4 @@
-# Copyright 2024-2025 The MathWorks, Inc.
+# Copyright 2024-2026 The MathWorks, Inc.
 # Build & Publish jupyter-mounted-matlab-notebook
 name: jupyter-mounted-matlab-notebook
 
@@ -20,10 +20,13 @@ on:
 
 jobs:
   build-and-publish-docker-image:
+    permissions:
+      contents: read
+      packages: write
     strategy:
       fail-fast: false
       matrix:
-        matlab_release_tag: [R2025b, R2025a, R2024b, R2024a, R2023b, R2023a, R2022b]
+        matlab_release_tag: [R2026a, R2025b, R2025a, R2024b, R2024a, R2023b, R2023a, R2022b]
     uses: ./.github/workflows/build-and-publish-docker-image.yml
     secrets: inherit
     with:
diff --git a/Dockerfile b/Dockerfile
@@ -1,6 +1,6 @@
-# Copyright 2024-2025 The MathWorks, Inc.
+# Copyright 2024-2026 The MathWorks, Inc.
 # Dockerfile for the MATLAB Integration for Jupyter based on quay.io/jupyter/base-notebook
-# With Python Version : 3.12
+# With Python Version : 3.13
 ###############################################################################
 # This Dockerfile is divided into multiple stages, the behavior of each stage
 #         is based on the build time args.
@@ -17,7 +17,7 @@
 # Example docker build commands are available at the end of this file.
 
 ## Setup Build Arguments, to chain multi-stage build selection.
-ARG MATLAB_RELEASE=R2025b
+ARG MATLAB_RELEASE=R2026a
 
 # See https://mathworks.com/help/install/ug/mpminstall.html for product list specfication
 ARG MATLAB_PRODUCT_LIST="MATLAB"
@@ -187,6 +187,7 @@ RUN python -m pip install -U jupyter-matlab-proxy
 
 FROM base3-with-jmp AS base3-with-jmp-with-vnc
 RUN echo "Installing jupyter-remote-desktop-proxy ..."
+RUN python -m pip install -U jupyter-remote-desktop-proxy
 USER root
 
 RUN export DEBIAN_FRONTEND=noninteractive && apt-get update \
@@ -203,14 +204,13 @@ RUN export DEBIAN_FRONTEND=noninteractive && apt-get update \
     # Disable the automatic screenlock since the account password is unknown
     && apt-get -y -qq remove xfce4-screensaver 
 
-# Pip install the latest version of the integration
 USER $NB_USER
 
 COPY --chown=$NB_UID:$NB_GID ./resources /home/${NB_USER}/matlab-resources
-# Move MATLAB resource files to the expected locations
-RUN python -m pip install -U jupyter-remote-desktop-proxy \
-    && export RESOURCES_LOC=/home/${NB_USER}/matlab-resources \
-    && mkdir -p ${HOME}/.local/share/applications ${HOME}/Desktop ${HOME}/.local/share/ ${HOME}/.icons \
+# Move MATLAB resource files to the expected locations. Also create Documents folder
+# as MATLAB will warn if it does not exist.
+RUN export RESOURCES_LOC=/home/${NB_USER}/matlab-resources \
+    && mkdir -p ${HOME}/.local/share/applications ${HOME}/Desktop ${HOME}/Documents ${HOME}/.local/share/ ${HOME}/.icons \
     && cp ${RESOURCES_LOC}/MATLAB.desktop ${HOME}/Desktop/ \
     && cp ${RESOURCES_LOC}/MATLAB.desktop ${HOME}/.local/share/applications\
     && ln -s ${RESOURCES_LOC}/matlab_icon.png ${HOME}/.icons/matlab_icon.png
diff --git a/README.md b/README.md
@@ -8,7 +8,7 @@ To run MATLAB&reg; in Jupyter&reg; inside a container, use the [Dockerfile](./Do
 
 ## Run in GitHub Codespaces
 
-To run this container, click the button below to start a [GitHub Codespace](https://docs.github.com/en/codespaces/about-codespaces/what-are-codespaces) with a [pre-built image](#pre-built-images) for MATLAB R2025b.
+To run this container, click the button below to start a [GitHub Codespace](https://docs.github.com/en/codespaces/about-codespaces/what-are-codespaces) with a [pre-built image](#pre-built-images) for MATLAB R2026a.
 
 [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/mathworks-ref-arch/matlab-integration-for-jupyter?devcontainer_path=.devcontainer%2Fdevcontainer.json)
 
@@ -36,12 +36,12 @@ cd matlab-integration-for-jupyter
 ### Build & Run Docker Container
 Build the container with a name and tag of your choice.
 ```bash
-docker build -t mifj:R2025a .
+docker build -t mifj:R2026a .
 ```
 
 Run the container.
 ```bash
-docker run -it -p 8888:8888 --rm mifj:R2025a
+docker run -it -p 8888:8888 --rm mifj:R2026a
 ```
 
 To open JupyterLab, use your browser to visit the address printed in your console of the format `http://<hostname>:8888/?token=<token>`. The `hostname` is the name of the computer running Docker, and the `token` is the secret token printed in the console. 
@@ -59,7 +59,7 @@ The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/ma
 
 | Argument Name | Description | Default value |
 |---|---|---|
-| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | The MATLAB release you want to install. | R2025a |
+| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | The MATLAB release you want to install. | R2026a |
 | [MATLAB_PRODUCT_LIST](#build-an-image-with-a-specific-set-of-products) | Products to install as a space-separated list. For more information, see [MPM.md](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/MPM.md). For example: MATLAB Simulink Deep_Learning_Toolbox Fixed-Point_Designer. | MATLAB |
 | [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | The path to install MATLAB. | /opt/matlab |
 | [LICENSE_SERVER](#build-an-image-configured-to-use-a-license-server) | The port and hostname of the machine that is running the Network License Manager, using the port@hostname syntax. For example: *27000@MyServerName* | *Unset* |
@@ -78,24 +78,24 @@ docker build --build-arg MATLAB_RELEASE=R2019b -t mifj:R2019b .
 #### Build an Image with Specific Products
 To build an image with MATLAB and Simulink, run:
 ```bash
-docker build --build-arg MATLAB_PRODUCT_LIST='MATLAB Simulink' -t mifj:R2025a .
+docker build --build-arg MATLAB_PRODUCT_LIST='MATLAB Simulink' -t mifj:R2026a .
 ```
 
 #### Build an Image with MATLAB Installed in a Specific Location
 To build an image with MATLAB installed at `/opt/matlab`, use this command.
 ```bash
-docker build --build-arg MATLAB_INSTALL_LOCATION='/opt/matlab' -t mifj:R2025a .
+docker build --build-arg MATLAB_INSTALL_LOCATION='/opt/matlab' -t mifj:R2026a .
 ```
 
 #### Build an Image Configured to Use a License Server
 
 If you include the license server information with the `docker build` command, you do not have to provide it when running the container.
 ```bash
 # Build container with the License Server.
-docker build --build-arg LICENSE_SERVER=27000@MyServerName -t mifj:R2025a .
+docker build --build-arg LICENSE_SERVER=27000@MyServerName -t mifj:R2026a .
 
 # Run the container, without providing license information.
-docker run -it --rm -p 8888:8888 mifj:R2025a 
+docker run -it --rm -p 8888:8888 mifj:R2026a 
 ```
 Alternatively, to provide the License Server information with `docker run`, you can use the environment variable `MLM_LICENSE_FILE`:
 ```bash
@@ -107,7 +107,7 @@ For more information on using the Network License Manager, see [Use the Network
 #### Build an Image with the MATLAB Engine for Python
 To build the default image along with the MATLAB Engine for Python for a given MATLAB Release, run:
 ```bash
-docker build --build-arg INSTALL_MATLABENGINE=1 --build-arg MATLAB_RELEASE=R2025a -t mifj:R2025a .
+docker build --build-arg INSTALL_MATLABENGINE=1 --build-arg MATLAB_RELEASE=R2026a -t mifj:R2026a .
 ```
 For more information, see: 
 - [MATLAB Engine for Python](https://github.com/mathworks/matlab-engine-for-python) (GitHub).
@@ -120,7 +120,7 @@ For more information, see:
 #### Build an Image with the Option to Access Desktop Using VNC
 To build the default image along with the ability to access an XFCE Desktop using VNC, run:
 ```bash
-docker build --build-arg INSTALL_VNC=1 -t mifj:R2025a .
+docker build --build-arg INSTALL_VNC=1 -t mifj:R2026a .
 ```
 For more information, see [Jupyter Remote Desktop Proxy (GitHub)](https://github.com/jupyterhub/jupyter-remote-desktop-proxy).
 
@@ -144,17 +144,17 @@ Use the [Dockerfile Build Arguments](https://docs.docker.com/reference/dockerfil
 
 ```bash
 docker build --build-arg MOUNT_MATLAB=1 \
-             --build-arg MATLAB_RELEASE=R2025a \
+             --build-arg MATLAB_RELEASE=R2026a \
              -t mifj:mounted .
 ```
 The `MATLAB_RELEASE` argument ensures that the system dependencies required for MATLAB are installed in the container.
 
 Note: When you are mounting MATLAB on the container at run time, you cannot install MATLAB Engine for Python at build time.
 
 #### Specify Mount Location at Container Startup
-If MATLAB is installed in `/usr/local/MATLAB/R2025a` on your local machine, you can bind mount this folder to `/opt/matlab` using the command shown below:
+If MATLAB is installed in `/usr/local/MATLAB/R2026a` on your local machine, you can bind mount this folder to `/opt/matlab` using the command shown below:
 ```bash
-docker run -it --rm -v /usr/local/MATLAB/R2025a:/opt/matlab:ro -p 8888:8888 mifj:mounted 
+docker run -it --rm -v /usr/local/MATLAB/R2026a:/opt/matlab:ro -p 8888:8888 mifj:mounted 
 ```
 For more information, see [Bind Mounts (Docker)](https://docs.docker.com/engine/storage/bind-mounts/).
 
@@ -166,9 +166,9 @@ This option is useful when you want to minimize the size of the container as ins
 To copy an existing MATLAB installation from another container image, specify the image name with the Docker Build Arguments `MATLAB_IMAGE_NAME` and `MATLAB_RELEASE` as shown below:
 
 ```bash
-# Copies MATLAB from the Dockerhub Image "mathworks/matlab:r2025a" into the image being built.
-docker build --build-arg MATLAB_IMAGE_NAME=mathworks/matlab:r2025a \
-             --build-arg MATLAB_RELEASE=R2025a \
+# Copies MATLAB from the Dockerhub Image "mathworks/matlab:r2026a" into the image being built.
+docker build --build-arg MATLAB_IMAGE_NAME=mathworks/matlab:r2026a \
+             --build-arg MATLAB_RELEASE=R2026a \
              -t mifj:copied .
 ```
 The `MATLAB_RELEASE` argument, ensures that the system dependencies required for MATLAB, are installed into the container.
@@ -186,12 +186,12 @@ These images are based on `jupyter/base-notebook:ubuntu-24.04` and include:
     * Only available in pre-built images newer than R2023b
     * See [Different Versions of OS or Python](#different-versions-of-os-or-python) for more information on installing the engine for older versions of MATLAB.
 
-**Available Tags**: `R2025b`, `R2025a`, `R2024b`, `R2024a`, `R2023b`, `R2023a`, `R2022b`
+**Available Tags**: `R2026a`, `R2025b`, `R2025a`, `R2024b`, `R2024a`, `R2023b`, `R2023a`, `R2022b`
 
 **Docker Pull Command**:
 ```bash
 # Substitute the tag with your desired version of MATLAB.
-docker pull ghcr.io/mathworks-ref-arch/matlab-integration-for-jupyter/jupyter-matlab-notebook:R2025a
+docker pull ghcr.io/mathworks-ref-arch/matlab-integration-for-jupyter/jupyter-matlab-notebook:R2026a
 ```
 ### jupyter-mounted-matlab-notebook
 These images are based on `jupyter/base-notebook:ubuntu-24.04` and include:
@@ -201,12 +201,12 @@ These images are based on `jupyter/base-notebook:ubuntu-24.04` and include:
     * Only available in pre-built images newer than R2023b
     * See [Compatibility for Different Versions of OS or Python](#compatibility-for-different-versions-of-os-or-python) for more information on installing the engine for older versions of MATLAB.
 
-**Available Tags**: `R2025b`, `R2025a`, `R2024b`, `R2024a`, `R2023b`, `R2023a`, `R2022b`
+**Available Tags**: `R2026a`, `R2025b`, `R2025a`, `R2024b`, `R2024a`, `R2023b`, `R2023a`, `R2022b`
 
 **Docker Pull Command**:
 ```bash
 # Substitute the tag with your desired version of MATLAB.
-docker pull ghcr.io/mathworks-ref-arch/matlab-integration-for-jupyter/jupyter-mounted-matlab-notebook:R2025a
+docker pull ghcr.io/mathworks-ref-arch/matlab-integration-for-jupyter/jupyter-mounted-matlab-notebook:R2026a
 ```
 Use the correct version of the image based on the MATLAB release you are mounting on the image.
 For example to mount `R2022b` from your local machine, that is installed in `/usr/local/MATLAB/R2022b`, use the following `docker run` command:
@@ -234,6 +234,6 @@ To submit an enhancement request or request technical support, create an [Issue]
 
 ----
 
-Copyright 2020-2025 The MathWorks, Inc.
+Copyright 2020-2026 The MathWorks, Inc.
 
 ----

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`		`- "name": "MATLAB R2025b",`
`3`		`- "image": "ghcr.io/prabhakk-mw/matlab-integration-for-jupyter/jupyter-matlab-notebook:r2025b",`
	`2`	`+ "name": "MATLAB R2026a",`
	`3`	`+ "image": "ghcr.io/mathworks-ref-arch/matlab-integration-for-jupyter/jupyter-matlab-notebook:r2026a",`
`4`	`4`	`// Configure VSCode Extensions`
`5`	`5`	`"customizations": {`
`6`	`6`	`"vscode": {`
Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@`
`13`	`13`	`"build": {`
`14`	`14`	`"dockerfile": "../../Dockerfile",`
`15`	`15`	`"args": {`
`16`		`- "MATLAB_RELEASE": "r2025b",`
	`16`	`+ "MATLAB_RELEASE": "r2026a",`
`17`	`17`	`"MATLAB_PRODUCT_LIST": "MATLAB Symbolic_Math_Toolbox Simulink",`
`18`	`18`	`"MATLAB_INSTALL_STAGE_SELECTOR": "using-mpm"`
`19`	`19`	`}`