You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
To run MATLAB® in Jupyter® inside a container, use the Dockerfile in this repository. The Dockerfile builds an image with [MATLAB Integration for Jupyter](https://github.com/mathworks/jupyter-matlab-proxy) (GitHub), based on a `jupyter/base-notebook:ubuntu-22.04` base image from [Jupyter Docker Stacks](https://github.com/jupyter/docker-stacks) (GitHub), which ships with Python 3.11.
4
+
To run MATLAB® in Jupyter® inside a container, use the Dockerfile in this repository. The Dockerfile builds an image with [MATLAB Integration for Jupyter](https://github.com/mathworks/jupyter-matlab-proxy) (GitHub), based on a `jupyter/base-notebook:ubuntu-24.04` base image from [Jupyter Docker Stacks](https://github.com/jupyter/docker-stacks) (GitHub), which ships with Python 3.12.
5
5
6
6
## Build Instructions
7
7
@@ -16,12 +16,12 @@ cd matlab-integration-for-jupyter
16
16
### Build & Run Docker Container
17
17
Build the container with a name and tag of your choice.
18
18
```bash
19
-
docker build -t mifj:R2024b.
19
+
docker build -t mifj:R2025a.
20
20
```
21
21
22
22
Run the container.
23
23
```bash
24
-
docker run -it -p 8888:8888 --rm mifj:R2024b
24
+
docker run -it -p 8888:8888 --rm mifj:R2025a
25
25
```
26
26
27
27
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.
@@ -39,7 +39,7 @@ The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/ma
39
39
40
40
| Argument Name | Description | Default value |
41
41
|---|---|---|
42
-
|[MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab)| The MATLAB release you want to install. |R2024b|
42
+
|[MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab)| The MATLAB release you want to install. |R2025a|
43
43
|[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 |
44
44
|[MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location)| The path to install MATLAB. | /opt/matlab |
45
45
|[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*|
# Run the container, without providing license information.
78
-
docker run -it --rm -p 8888:8888 mifj:R2024b
78
+
docker run -it --rm -p 8888:8888 mifj:R2025a
79
79
```
80
80
Alternatively, to provide the License Server information with `docker run`, you can use the environment variable `MLM_LICENSE_FILE`:
81
81
```bash
82
-
docker run -it --rm -p 8888:8888 -e MLM_LICENSE_FILE=27000@MyServerName mifj:R2024b
82
+
docker run -it --rm -p 8888:8888 -e MLM_LICENSE_FILE=27000@MyServerName mifj:R2025a
83
83
```
84
84
85
85
For more information on using the Network License Manager, see [Use the Network License Manager](https://github.com/mathworks-ref-arch/matlab-dockerfile?tab=readme-ov-file#use-the-network-license-manager) for more information.
86
86
87
87
#### Build an Image with the MATLAB Engine for Python
88
88
To build the default image along with the MATLAB Engine for Python for a given MATLAB Release, run:
For more information, see [MATLAB Integration for Jupyter using VNC*(GitHub)*](https://github.com/mathworks/jupyter-matlab-vnc-proxy).
106
106
@@ -124,17 +124,17 @@ Use the [Dockerfile Build Arguments](https://docs.docker.com/reference/dockerfil
124
124
125
125
```bash
126
126
docker build --build-arg MOUNT_MATLAB=1 \
127
-
--build-arg MATLAB_RELEASE=R2024b \
127
+
--build-arg MATLAB_RELEASE=R2025a \
128
128
-t mifj:mounted .
129
129
```
130
130
The `MATLAB_RELEASE` argument ensures that the system dependencies required for MATLAB are installed in the container.
131
131
132
132
Note: When you are mounting MATLAB on the container at run time, you cannot install MATLAB Engine for Python at build time.
133
133
134
134
#### Specify Mount Location at Container Startup
135
-
If MATLAB is installed in `/usr/local/MATLAB/R2024b` on your local machine, you can bind mount this folder to `/opt/matlab` using the command shown below:
135
+
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:
136
136
```bash
137
-
docker run -it --rm -v /usr/local/MATLAB/R2024b:/opt/matlab:ro -p 8888:8888 mifj:mounted
137
+
docker run -it --rm -v /usr/local/MATLAB/R2025a:/opt/matlab:ro -p 8888:8888 mifj:mounted
138
138
```
139
139
For more information, see [Bind Mounts (Docker)](https://docs.docker.com/engine/storage/bind-mounts/).
140
140
@@ -146,9 +146,9 @@ This option is useful when you want to minimize the size of the container as ins
146
146
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:
147
147
148
148
```bash
149
-
# Copies MATLAB from the Dockerhub Image "mathworks/matlab:r2024b" into the image being built.
The `MATLAB_RELEASE` argument, ensures that the system dependencies required for MATLAB, are installed into the container.
@@ -158,35 +158,35 @@ The `MATLAB_RELEASE` argument, ensures that the system dependencies required for
158
158
You can download several Docker images based on this Dockerfile from the GitHub Container Registry.
159
159
160
160
### jupyter-matlab-notebook
161
-
These images are based on `jupyter/base-notebook:ubuntu-22.04` and include:
161
+
These images are based on `jupyter/base-notebook:ubuntu-24.04` and include:
162
162
* MATLAB
163
163
* MATLAB Integration for Jupyter
164
164
* MATLAB Integration for Jupyter using VNC
165
165
* MATLAB Engine for Python
166
166
* Only available in pre-built images newer than R2023b
167
167
* 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.
These images are based on `jupyter/base-notebook:ubuntu-22.04` and include:
177
+
These images are based on `jupyter/base-notebook:ubuntu-24.04` and include:
178
178
* MATLAB Integration for Jupyter
179
179
* MATLAB Integration for Jupyter using VNC
180
180
* MATLAB Engine for Python
181
181
* Only available in pre-built images newer than R2023b
182
182
* 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.
Use the correct version of the image based on the MATLAB release you are mounting on the image.
192
192
For example to mount `R2022b` from your local machine, that is installed in `/usr/local/MATLAB/R2022b`, use the following `docker run` command:
@@ -206,14 +206,14 @@ This might be useful if your workflow depends on older versions of Python. For e
206
206
207
207
### MATLAB Dependencies
208
208
209
-
To verify that the release of MATLAB you are installing is supported for your operating system, consult the [MATLAB Dependencies](https://github.com/mathworks-ref-arch/container-images/tree/main/matlab-deps) repository. For example, R2024b is currently the only MATLAB Release which supports Ubuntu 24.04.
209
+
To verify that the release of MATLAB you are installing is supported for your operating system, consult the [MATLAB Dependencies](https://github.com/mathworks-ref-arch/container-images/tree/main/matlab-deps) repository.
210
210
211
211
## Support & Feedback
212
212
To submit an enhancement request or request technical support, create an [Issue](https://github.com/mathworks-ref-arch/matlab-integration-for-jupyter/issues/new).
0 commit comments