Adds support for building Windows container images with MATLAB for non-interactive workflows

resolves #126

Author: drobinson0

README.md

@@ -2,13 +2,15 @@
 
 This repository shows you how to build and customize a Docker® container for MATLAB® and its toolboxes, using the [MATLAB Package Manager](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/MPM.md) (`mpm`). You can use this container image as a scalable and reproducible method to deploy and test your MATLAB code.
 
-Use the [Dockerfile](Dockerfile) in this top-level repository if you want a lightweight and simple way to create a MATLAB container image. You can also download prebuilt images based on the Dockerfile from [here](https://github.com/mathworks-ref-arch/matlab-dockerfile/pkgs/container/matlab-dockerfile%2Fmatlab). 
-
+Use the [Dockerfile](Dockerfile) in this top-level repository if you want a lightweight and simple way to create a MATLAB container image. You can also download prebuilt images based on the Dockerfile from [this GitHub® repository](https://github.com/mathworks-ref-arch/matlab-dockerfile/pkgs/container/matlab-dockerfile%2Fmatlab).
+ 
+To build a Windows® container for MATLAB, see the [**windows folder**](windows). This container supports non-interactive MATLAB workflows only, such as running scripts, batch jobs, or automating tasks in continuous integration and continuous delivery (CI/CD) pipelines.
+ 
 For alternative resources, see the [**alternates folder**](alternates) that contains the following Dockerfiles: 
 
 * The Dockerfile in [matlab-installer](alternates/matlab-installer) uses the MATLAB installer rather than `mpm` to install MATLAB in the container. This allows you to install toolboxes that are not currently supported by mpm. Use this Dockerfile if you prefer using the MATLAB installer workflow, instead of `mpm`.
 * The Dockerfile in [building-on-matlab-docker-image](alternates/building-on-matlab-docker-image) shows you how to build on top of the [MATLAB Container Image on Docker Hub](https://hub.docker.com/r/mathworks/matlab). Use this Dockerfile if you want to install extra toolboxes on top of the `mathworks/matlab` container image. This Dockerfile contains the features of the MATLAB image on Docker Hub, allowing you to access the dockerised MATLAB through a browser, batch mode, or an interactive command prompt.
-* The Dockerfile in [non-interactive](alternates/non-interactive) allows you run MATLAB in non-interactive environments. This Dockerfile requires that you have a MATLAB batch licensing token to license MATLAB in the container. Use this Dockerfile in continuous integration and continuous delivery (CI/CD) pipelines or other automated environments where interactive licensing is not possible.
+* The Dockerfile in [non-interactive](alternates/non-interactive) allows you run MATLAB in non-interactive environments. This Dockerfile requires that you have a MATLAB batch licensing token to license MATLAB in the container. Use this Dockerfile in CI/CD pipelines or other automated environments where interactive licensing is not possible.
 * The Dockerfile in [matlab-container-offline-install](alternates/matlab-container-offline-install/) shows you how to build and customize a Docker container for MATLAB and its toolboxes in an offline environment. Use this Dockerfile if you must build your container image in an offline environment.
 
 For more Docker related resources, see [More MATLAB Docker Resources](#more-matlab-docker-resources). 
@@ -21,7 +23,7 @@ For more Docker related resources, see [More MATLAB Docker Resources](#more-matl
 
 ### Get Sources
 
-Access the Dockerfile either by directly downloading this repository from GitHub®,
+Access the Dockerfile either by directly downloading this repository from GitHub,
 or by cloning this repository and
 then navigating to the appropriate folder.
 ```bash

windows/Dockerfile

@@ -0,0 +1,53 @@
+# Copyright 2025 The MathWorks, Inc.
+# This Dockerfile allows you to build a Windows® Docker® image with MATLAB® using the MATLAB Package Manager.
+# You can then use a MATLAB batch licensing token to license MATLAB in the container. Use the optional build arguments to
+# customize the version of MATLAB, and the list of products to install.
+
+# Here is an example docker build command with the optional build arguments.
+# docker build --build-arg MATLAB_RELEASE=R2025a
+#              --build-arg MATLAB_PRODUCT_LIST="MATLAB Deep_Learning_Toolbox Symbolic_Math_Toolbox"
+#              -t my_matlab_image_name .
+
+# To specify which MATLAB release to install in the container, edit the value of the MATLAB_RELEASE argument.
+# Use uppercase to specify the release, for example: ARG MATLAB_RELEASE=R2021b
+ARG MATLAB_RELEASE="R2025a"
+
+# Specify the list of products to install into MATLAB.
+ARG MATLAB_PRODUCT_LIST="MATLAB"
+
+# This Dockerfile uses the Windows base image which contains the full Windows API set. For details, see https://hub.docker.com/r/microsoft/windows
+FROM mcr.microsoft.com/windows:ltsc2019
+
+ARG MATLAB_RELEASE
+ARG MATLAB_PRODUCT_LIST
+
+# Set the shell to be powershell, and stop on errors
+SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'Continue'; $verbosePreference='Continue';"]
+
+# Run mpm to install MATLAB in the target location and delete the mpm installation afterwards.
+# If mpm fails to install successfully, then print the logfile in the terminal, otherwise clean up.
+RUN Invoke-WebRequest -OutFile "$Env:TEMP\mpm.exe" -Uri "https://www.mathworks.com/mpm/win64/mpm" ; \
+    $PRODUCT_LIST = -split $Env:MATLAB_PRODUCT_LIST ; \
+    & "$Env:TEMP\mpm.exe" install --release $Env:MATLAB_RELEASE --destination "C:\MATLAB" $PRODUCT_LIST ; \
+    if ($LASTEXITCODE -ne 0) { \
+        Get-Content "$Env:TEMP\mathworks_$Env:USERNAME.log"; throw \
+    } else { \
+        Remove-Item "$Env:TEMP\mpm.exe" ; Remove-Item "$Env:TEMP\mathworks_$Env:USERNAME.log" \
+    }
+
+# Install matlab-batch to enable the use of MATLAB batch licensing tokens.
+RUN Set-ExecutionPolicy RemoteSigned -Scope Process ; \
+    Invoke-WebRequest -OutFile $Env:TEMP\install-matlab-batch.ps1 -Uri  "https://raw.githubusercontent.com/mathworks-ref-arch/matlab-dockerfile/main/alternates/non-interactive/install/install-matlab-batch.ps1" ; \
+     & $Env:TEMP\install-matlab-batch.ps1 ; \
+     Remove-Item $Env:TEMP\install-matlab-batch.ps1
+
+# The following environment variables allow MathWorks to understand how this MathWorks
+# product (MATLAB On Windows Dockerfile) is being used. This information helps us make MATLAB even better.
+# Your content, and information about the content within your files, is not shared with MathWorks.
+# To opt out of this service, delete the environment variables defined in the following line.
+# To learn more, see the Help Make MATLAB Even Better section in the accompanying README:
+# https://github.com/mathworks-ref-arch/matlab-dockerfile#help-make-matlab-even-better
+ENV MW_DDUX_FORCE_ENABLE=true MW_CONTEXT_TAGS=MATLAB:WINDOWSNONINTERACTIVE:DOCKERFILE:V1
+
+# Set the entrypoint
+ENTRYPOINT ["powershell.exe"]

windows/Makefile.ps1

@@ -0,0 +1,50 @@
+# Copyright 2025 The MathWorks, Inc.
+# This script allows you to run build and test targets of a GitHub actions pipeline in an identical manner on your local machine.
+# This ensures that the build and test actions are easily reproducible outside of a CI/CD pipeline.
+param(
+    [Parameter(Mandatory=$False, Position=1, ValueFromPipeline=$false)]
+    [System.String]
+    $Release = "R2025a",
+    
+    [Parameter(Mandatory=$False, Position=1, ValueFromPipeline=$false)]
+    [System.String]
+    $ProductList = "MATLAB Text_Analytics_Toolbox Simulink_Coder Embedded_Coder MATLAB_Support_for_MinGW-w64_C/C++/Fortran_Compiler Requirements_Toolbox",
+    
+    [Parameter(Mandatory=$False, Position=1, ValueFromPipeline=$false)]
+    [System.String]
+    $Token = "",
+    
+    [Parameter(Mandatory=$False, Position=1, ValueFromPipeline=$false)]
+    [System.String]
+    $Target = "BuildAndTest"
+)
+
+$script:ImageName="mathworks/matlab-on-windows"
+$script:Version="0.5.1"
+
+function Build {
+        $Tag = ${Release}.ToLower() + "_" + ${Version}
+        & docker build --build-arg MATLAB_RELEASE=${Release} --build-arg MATLAB_PRODUCT_LIST="${ProductList}" -t "${ImageName}:${Tag}" .
+}
+
+function Test {
+        if (${Token} -eq "") {
+            Write-Error "Token argument must be supplied to test command"
+            throw "input error"
+        }
+        $Tag = ${Release}.ToLower() + "_" + ${Version}
+	$container = New-PesterContainer -Path .\test\Test-MATLABWindowsContainer.tests.ps1 -Data @{ Release = ${Release}; ImageName = "${ImageName}:${Tag}"; Token = ${Token} }
+        & Invoke-Pester -Container $container -Output Detailed
+}
+
+function BuildAndTest {
+    Build
+    Test
+}
+
+switch (${Target}) {
+    'Build' { Build }
+    'Test' { Test }
+    'BuildAndTest' { BuildAndTest }
+    default { BuildAndTest }
+}

windows/README.md

@@ -0,0 +1,95 @@
+# Create a Windows Container Image for MATLAB
+
+This repository shows you how to build and customize a Windows® Docker® container for MATLAB® and its toolboxes, using the [MATLAB Package Manager](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/MPM.md) (`mpm`) and [MATLAB Batch Licensing (`matlab-batch`)](../alternates/non-interactive/MATLAB-BATCH.md). You can use this container image as a scalable and reproducible method to deploy and test your MATLAB code on a Windows platform.
+
+Use this Dockerfile if you have a MATLAB batch licensing token to license MATLAB in your container. The MATLAB batch licensing project is still in the pilot phase. To inquire about eligibility requirements, fill out this form on the MathWorks® website: [Batch Licensing Pilot Eligibility](https://www.mathworks.com/support/batch-tokens.html).
+
+### Requirements
+* MATLAB Batch Licensing Token. For more information, see [Use MATLAB Batch Licensing](../alternates/non-interactive/MATLAB-BATCH.md#matlab-batch-licensing-token).
+* Docker Desktop for Windows® (Windows 10 or later) or a Windows Server® build host (Windows Server 2016 or later).
+
+## Build Instructions
+### Get the Dockerfile
+
+Access this Dockerfile either by directly downloading this repository from GitHub®, or by cloning this repository and then navigating to the appropriate subfolder.
+```bash
+git clone https://github.com/mathworks-ref-arch/matlab-dockerfile.git
+cd matlab-dockerfile/windows/
+```
+
+### Build and Run Docker Image
+
+Build container with a name and tag of your choice.
+```powershell
+docker build -t matlab-on-windows:R2025a .
+```
+This [Dockerfile](./Dockerfile) defaults to building a Windows container for MATLAB R2025a. The Dockerfile is based on the Windows base image which contains the full Windows API set. For details, see the documentation on DockerHub for [Windows base image](https://hub.docker.com/r/microsoft/windows).
+
+Test the container by running an example MATLAB command, such as `ver`. The entry point of the container is PowerShell.
+```powershell
+docker run --rm matlab-on-windows:R2025a matlab-batch "-licenseToken" "[email protected]::encodedToken" "ver"
+```
+For more information on running the container, see [Run the Container](#run-the-container).
+
+## Customize the Image
+
+By default, the [Dockerfile](Dockerfile) installs the latest available MATLAB release without any additional toolboxes or products, as well as the latest version of [**matlab-batch**](../alternates/non-interactive/MATLAB-BATCH.md).
+
+Use the options below to customize your build.
+
+### Customize MATLAB Release and MATLAB Product List
+The [Dockerfile](Dockerfile) supports these Docker build-time variables:
+
+| Argument Name | Default Value | Description |
+|---|---|---|
+| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | R2025a | MATLAB release to install, for example, `R2023b`. |
+| [MATLAB_PRODUCT_LIST](#build-an-image-with-a-specific-set-of-products) | MATLAB | Space-separated list of products to install. For help specifying the products to install, see the "products" input argument on the [documentation page for the mpm install function](https://www.mathworks.com/help/install/ug/mpminstall.html). For example: `MATLAB Simulink Deep_Learning_Toolbox Fixed-Point_Designer` |
+
+Use these arguments with the `docker build` command to customize your image.
+Alternatively, the default values for these arguments can be changed directly in the [Dockerfile](Dockerfile).
+
+> Note: MATLAB is installed to `C:\MATLAB` in the Windows container because the default `matlabroot` location can cause issues with compiler products. For details about the issues, see [Build Process Support for File and Folder Names](https://www.mathworks.com/help/coder/ug/enable-build-process-for-folder-names-with-spaces.html) and this [MATLAB Answer](https://www.mathworks.com/matlabcentral/answers/95399-why-is-the-build-process-failing-with-error-code-nmake-fatal-error-u1073-don-t-know-how-to-make). Additionally, you cannot use the suggested 8.3 short file names as a workaround because it is not supported in Windows containers. For details, see this [GitHub issue](https://github.com/microsoft/Windows-Containers/issues/507). 
+
+### Build an Image for a Different Release of MATLAB
+
+For example, to build an image for MATLAB R2021b, use this command.
+```powershell
+docker build --build-arg MATLAB_RELEASE=R2021b -t matlab-windows:R2021b .
+```
+
+For supported releases, see [MATLAB Batch Licensing support](../alternates/non-interactive/MATLAB-BATCH.md#limitations).
+
+### Build an Image with a Specific Set of Products
+
+For example, to build an image with MATLAB and the Statistics and Machine Learning Toolbox™, use this command.
+```powershell
+docker build --build-arg MATLAB_PRODUCT_LIST="MATLAB Statistics_and_Machine_Learning_Toolbox" -t matlab-stats-windows:R2025a .
+```
+
+## Run the Container
+To start a container and run MATLAB with a MATLAB batch licensing token, open a Windows PowerShell and enter this command:
+```powershell
+# Start MATLAB, display 'hello world', and exit.
+docker run --rm matlab-on-windows:R2025a matlab-batch -licenseToken '[email protected]::encodedToken' '\"disp(''hello world'')\"'
+```
+Note that you must use the rules for using single and double quotation marks in PowerShell. For details, see [about quoting rules](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_quoting_rules).
+
+Alternatively, you can run a script `myscript.m` containing MATLAB code:
+
+```powershell
+# Launch MATLAB, run `myscript.m` and exit:
+docker run --mount "type=bind,src=C:\scripts,target=C:\pwd" --workdir "C:\pwd" --rm matlab-on-windows:R2025a matlab-batch -licenseToken '[email protected]::encodedToken' 'myscript'
+```
+
+You can also set your MATLAB batch licensing token at the container level by setting the `MLM_LICENSE_TOKEN` environment variable. For example:
+
+```powershell
+# Start MATLAB, display 'hello world', and exit.
+docker run -e MLM_LICENSE_TOKEN='[email protected]::encodedToken' --rm matlab-on-windows:R2025a matlab-batch '\"disp(''hello world'')\"'
+```
+
+## Feedback
+We encourage you to try this repository with your environment and provide feedback. If you encounter a technical issue or have an enhancement request, create an issue [here](https://github.com/mathworks-ref-arch/matlab-dockerfile/issues).
+
+---
+Copyright 2025 The MathWorks, Inc.

windows/test/Test-MATLABWindowsContainer.tests.ps1

@@ -0,0 +1,38 @@
+# Copyright 2025 The MathWorks, Inc.
+# Requires v5.0 of pester 
+param (
+    [Parameter(Mandatory)]
+    [string] $ImageName,
+
+    [Parameter(Mandatory)]
+    [string] $Token,
+
+    [Parameter(Mandatory)]
+    [string] $Release
+)
+
+Describe "MATLAB Docker Container Tests" {
+    It "Runs rand() and returns expected output" {
+        $result = docker run -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'rand()'"
+        $LASTEXITCODE | Should -Be 0
+        $result -join "`n" | Should -Match "0.8147"
+    }
+
+    It "Runs ver and includes release string" {
+        $result = docker run -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'ver'"
+        $LASTEXITCODE | Should -Be 0
+        $result -join "`n" | Should -Match $Release
+    }
+
+    It "Runs peaks and returns expected expression" {
+        $result = docker run -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'peaks'"
+        $LASTEXITCODE | Should -Be 0
+        $result -join "`n" | Should -Match "z =  3\*\(1-x\)\.\^2\.\*exp\(-\(x\.\^2\) - \(y\+1\)\.\^2\)"
+    }
+
+    It "Creates a plot and confirms file existence" {
+        $result = docker run -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" '\"figure; annotation(''ellipse'',  [.2 .2 .2 .2]); saveas(gcf, ''plot.png''); isfile(''plot.png'')\"'
+        $LASTEXITCODE | Should -Be 0
+        $result -join "`n" | Should -BeLike "*ans =*logical*1*"
+    }
+}