mpm install

(Linux, Windows, Mac) Install products from operating system command line

Using mpm install at the operating system command line requires MATLAB^® Package Manager. See Get MATLAB Package Manager.

If you instead want to manage packages within MATLAB, see Package Management (MATLAB).

Syntax

mpm install --release=<release> --destination=</full/path/to/destination> --products=<product1> ... <productN>

mpm install --source=</full/path/to/source> --destination=</full/path/to/destination> --products=<product1> ... <productN>

mpm install ... [options]

mpm install --inputfile=</full/path/to/file>

Description

mpm install --release=<release> --destination=</full/path/to/destination> --products=<product1> ... <productN> installs MathWorks^® products and support packages for a release to the specified installation folder. mpm also installs any required products, if they are not installed already.

Run mpm install from the operating system command line. You can also use this command in a MATLAB Dockerfile to create a MATLAB container image. For more details, see Create a MATLAB Container Image on GitHub^®.

mpm install --source=</full/path/to/source> --destination=</full/path/to/destination> --products=<product1> ... <productN> specifies the installation source. Valid sources include products and support packages downloaded using mpm download or a mounted product ISO image downloaded from MathWorks Downloads. If you do not specify --source, then mpm installs products from mathworks.com.

mpm install ... [options] sets additional product installation options, using either of the previous syntaxes. For example, you can omit the installation of GPU libraries when installing Parallel Computing Toolbox™, or omit the installation of the default Java^® Runtime Environment (JRE) used by MATLAB. You can specify options in any order.

mpm install --inputfile=</full/path/to/file> installs products using an input file. You can download a template input file for your release from the mpm-input-files folder on GitHub. You must specify --inputfile without any other options.

Examples

Install Products

Install the latest release of Simulink^® and Deep Learning Toolbox™ Model for ResNet-50 Network. If they are not already installed, mpm also installs the required products: MATLAB and Deep Learning Toolbox.

Linux^® or Mac:

./mpm install --release=R2024b --destination=/home/<USER>/matlab --products=Simulink Deep_Learning_Toolbox_Model_for_ResNet-50_Network

Windows^® (run as administrator):

.\mpm.exe install --release=R2024b --destination="C:\Users\<USER>\matlab" --products=Simulink Deep_Learning_Toolbox_Model_for_ResNet-50_Network

You can install additional products later. For example, add Robotics System Toolbox™ to the installation.

Linux or Mac:

./mpm install --release=R2024b --destination=/home/<USER>/matlab --products=Robotics_System_Toolbox

Windows (run as administrator):

.\mpm.exe install --release=R2024b --destination="C:\Users\<USER>\matlab" --products=Robotics_System_Toolbox

Install Products from Downloaded Source Folder

Install MathWorks products and support packages from a source folder containing products downloaded using mpm download. If your source folder is from a mounted ISO image containing MathWorks products, see the example Install Products from Mounted ISO Image instead.

1. Download the latest release of Simulink and Deep Learning Toolbox Model for ResNet-50 Network to a folder on your computer. mpm also includes the required products in the download, MATLAB and Deep Learning Toolbox.

   Linux or Mac:

   ./mpm download --release=R2024b --destination=/home/<USER>/downloads/mathworks --products=Simulink Deep_Learning_Toolbox_Model_for_ResNet-50_Network

   Windows (run as administrator):

   .\mpm.exe download --release=R2024b --destination="C:\Users\<USER>\Downloads\MathWorks" --products=Simulink Deep_Learning_Toolbox_Model_for_ResNet-50_Network

2. (Optional) To install the products on a different computer, make the downloaded folder available for installation on the target computer by doing one of the following:

   • Copy the folder to a shared network drive that the computer can access.

   • Copy the folder directly to the computer using removable media.

3. Install the downloaded products on the target computer using mpm install.

   • Using the --source option, specify the absolute path to the downloaded folder. This example assumes that you are downloading and installing the products on the same computer, so the --destination option of mpm download and the --source option of mpm install specify the same folder.

   • Using the --destination option, specify the absolute path to the location where you want to install the products.

   • Using the --products option, specify the products you want to install. mpm also installs the required products, MATLAB and Deep Learning Toolbox.

   Linux or Mac:

   ./mpm install --destination=/home/<USER>/matlab --source=/home/<USER>/downloads/mathworks --products=Simulink Deep_Learning_Toolbox_Model_for_ResNet-50_Network

   Windows (run as administrator):

   .\mpm.exe install --destination="C:\Users\<USER>\matlab" --source="C:\Users\<USER>\Downloads\MathWorks" --products=Simulink Deep_Learning_Toolbox_Model_for_ResNet-50_Network

Install Products from Mounted ISO Image

Since R2022a

Install products from an ISO image mounted to a drive on your computer. This example runs on Linux and Windows only. On Mac platforms, installing products from a mounted DMG image is not supported.

1. From MathWorks Downloads, get an ISO image containing MATLAB and Simulink products. To get an ISO image, you must be a license administrator.

2. Mount the image. For instructions on mounting an image for your platform, see the support article How do I install MathWorks products using an ISO or DMG image?

3. Install products from this image by specifying the path to the image in the --source option. For example:

   Linux:

   ./mpm install --source=/path/to/mounted/image --destination=/home/<USER>/matlab --products=MATLAB
   

   Windows (run as administrator):

   .\mpm.exe install --source="\path\to\mounted\image" --destination="C:\Users\<USER>\matlab" --products=MATLAB
   

Install Products Using Optional Command-Line Inputs

Install the latest MATLAB release without the default JRE used by MATLAB. Also install Parallel Computing Toolbox but without the GPU libraries to reduce the installation size.

Linux or Mac:

./mpm install --release=R2024b --products=MATLAB Parallel_Computing_Toolbox --no-gpu --no-jre

Windows (run as administrator):

.\mpm.exe install --release=R2024b --products=MATLAB Parallel_Computing_Toolbox --no-gpu --no-jre

After installing MATLAB, you must set a supported custom JRE, or MATLAB will not run. To set a custom JRE, see the support article for your operating system:

• Set Custom JRE for MATLAB on Linux

• Set Custom JRE for MATLAB on Windows

• Set Custom JRE for MATLAB on macOS

Install Products Using Input File

Install products and support packages for the latest MATLAB release by specifying installation options in an input file.

1. From the mpm-input-files folder, open the folder for the latest MATLAB release, and download a copy of the mpm_input_<release>.txt file.

2. In the downloaded file, configure the MATLAB installation by uncommenting lines that start with a single # and updating their values.

   Specify the installation options.

   • Release Update Level (Optional)

     By default, mpm installs the latest versions of MATLAB products for the given release.

     To install a specific release update, uncomment the updateLevel line and change the update level. For example:

     • updateLevel=0 installs the general release.

     • updateLevel=1 installs update 1.

   • Installation Folder (Optional)

     By default, mpm installs MATLAB products to the default destination folder for that computer's platform.

     To change the destination folder, uncomment the destinationFolder line and specify the path to the folder.

     Linux or Mac example:

     destinationFolder=/home/<USER>/matlab

     Windows example:

     destinationFolder="C:\Users\<USER>\matlab"

   Specify the products and support packages to install.

   • Products

     Uncomment the product.Simulink and product.Statistics_and_Machine_Learning_Toolbox lines for installing Simulink and Statistics and Machine Learning Toolbox™. You do not need to uncomment the required product, MATLAB, because mpm installs required products automatically.

     product.Simulink
     # ...
     product.Statistics_and_Machine_Learning_Toolbox

   • Support Packages

     Uncomment the product.Deep_Learning_Toolbox_Model_for_ResNet-50_Network line to install Deep Learning Toolbox Model for ResNet-50 Network. You do not need to uncomment the required product, Deep Learning Toolbox.

     product.Deep_Learning_Toolbox_Model_for_ResNet-50_Network

   Save the file.

3. Install the products and support package using mpm install. Specify the full path to the input file you downloaded and updated.

   Linux or Mac:

   ./mpm install --inputfile=/path/to/file/mpm_input_<release>.txt
   

   Windows (run as administrator):

   .\mpm.exe install --inputfile="\path\to\file\mpm_input_<release>.txt"

Input Arguments

--release=<release> — Release to install

MATLAB release name

Release to install, specified as a MATLAB release name.

• To install the latest version of a release, which includes all updates, specify only the release name, for example R2024b.

• To install a specific update release, specify the release name with an update number suffix, for example R2024bU4.

• To install the initial version of a release, without any updates, specify the release name with an update 0 suffix, for example R2024bU0.

Example: --release R2024b

--destination=</full/path/to/destination> — Product installation folder

absolute folder path

Product installation folder, specified as an absolute folder path. If the destination folder does not exist, mpm creates it, including any intermediate folders.

Note

You cannot use --destination to set the support package installation folder. mpm automatically derives this folder from the product installation folder specified by --destination. To change the support package installation folder, install MATLAB and then run the function matlabshared.supportpkg.setSupportPackageRoot (MATLAB).

If you are installing products for an existing MATLAB installation, specify the absolute path to the folder where MATLAB is installed.

If you do not set --destination, then mpm installs to the following locations by default, where <release> is the specified --release option.

Platform	Default Installation Destination
Linux	/usr/local/MATLAB/<release>
Windows	C:\Program Files\MATLAB\<release>
Mac	/Applications/MATLAB_<release>.app

--products=<product1> ... <productN> — Products and support packages to install

list of product and support package names

Products and support packages to install, specified as a list of product and support package names, separated by spaces.

For the full list of products and support packages that mpm can install, open the input file for your release from the mpm-input-files folder on GitHub. For information on products that mpm is unable to install, see Limitations.

When specifying products, use the format shown in the input file. For example, suppose you want to install Computer Vision Toolbox™. In the input file, the line containing this product is formatted as follows, with spaces replaced by underscores:

#product.Computer_Vision_Toolbox

Copy the text after the dot into the --products option.

--products=Computer_Vision_Toolbox

You do not need to specify required products. If a product or support package requires another product, mpm includes it in the installation.

If a product or support package name includes parentheses and your command-line shell does not interpret parentheses as text, enclose the name in quotes. For example:

--products=Simulink "Computer_Vision_Toolbox_Model_for_R(2+1)D_Video_Classification"

Example: --products=MATLAB Simulink Fixed-Point_Designer installs MATLAB, Simulink, and Fixed-Point Designer™.

Example: --products=Deep_Learning_Toolbox installs Deep Learning Toolbox and its required product, MATLAB.

--source=</full/path/to/source> — Installation source

absolute file path

Installation source, specified as an absolute file path to one of the following installation sources:

• Folder containing products and support packages downloaded using mpm download. For example:

  --source=/home/<USER>/downloads/mathworks

  For details on obtaining this source, see the example Install Products from Downloaded Source Folder.

• Mounted product ISO image downloaded from MathWorks Downloads. For example:

  --source=/mnt/mathworks/matlab.iso

  For details on obtaining this source, see the example Install Products from Mounted ISO Image. (since R2022a)

If you do not set --source, then mpm downloads the product files from MathWorks.

--inputfile=</full/path/to/file> — Input file for configuring installation

absolute file path

Input file for configuring your installation, specified as the absolute path to a valid input file.

Download a template input file for your release from the mpm-input-files folder on GitHub. Using this file, you can specify the installation folder and select the products and support packages you want to install without having to enter them at the command line. You must specify --inputfile without any other options.

Example: --inputfile=/home/<USER>/matlab/mpm_input_r2024a.txt

--no-gpu — Option to omit installation of GPU libraries when installing Parallel Computing Toolbox

Since R2023a

Option to omit the installation of the GPU libraries that are included, by default, in installations of Parallel Computing Toolbox. If you do not intend to use GPU computing in MATLAB, specify this option to reduce the size of the installation.

You can install the GPU libraries later by calling a GPU function, such as gpuArray or gpuDevice, in MATLAB.

--no-jre — Option to omit installation of default Java Runtime Environment

Option to omit the installation of the default Java Runtime Environment (JRE) used by MATLAB, so that you can set a custom JRE instead. You must set a supported JRE, or MATLAB will not run. For details, see one of these support articles:

• Set Custom JRE for MATLAB on Linux

• Set Custom JRE for MATLAB on Windows

• Set Custom JRE for MATLAB on macOS

--doc — Option to include documentation with MATLAB installation

R2022a and R2022b only

Option to include documentation with the MATLAB installation.

In R2022a and later releases, the documentation is not included in the installation by default, and MATLAB uses the web documentation instead. To include the documentation in the R2022a and R2022b releases, specify the --doc option. In R2021b and earlier releases, the documentation is included in the installation by default.

To include the documentation in R2023a and later releases, use mpm install-doc.

Limitations

• mpm supports installing products and support packages for these releases only:

  • Products — R2017b or later

  • Support packages — R2019a or later

• Not all MathWorks products are available for all operating systems and architectures that MATLAB supports:

  • Products Not Available for Linux

  • Products Not Available for Mac

  • Products Not Available for Apple silicon Macs

• mpm supports installing specific update releases only for R2021b and later. For R2021a and earlier, mpm always installs the latest update release.

• On Mac, installing products from a mounted DMG image is not supported.

• On Windows, you cannot uninstall products that were installed using mpm.

• mpm supports installing the following products only from a mounted product ISO image. For an example, see Install Products from Mounted ISO Image.

  • IEC Certification Kit

  • DO Qualification Kit

  • Simulink Code Inspector™

  • Polyspace^® Client™ for Ada

  • Polyspace Server™ for Ada

• mpm does not support installing these support packages:

  • Image Acquisition Toolbox™ Support Package for GenICam™ Interface

  • Image Acquisition Toolbox Support Package for GigE Vision^® Hardware

  • Simulink Coder™ Support Package for BBC micro:bit

  • MATLAB Support Package for IP Cameras

  • New Desktop for MATLAB

  • MATLAB Support Package for Parrot^® Drones

  • MATLAB Support Package for Ryze Tello Drones

  • Simulink Real-Time™ Support Package

  To download and install these support packages:

  1. Download the Support Software Downloader for your platform.

  2. Run the downloader. Select your release, the support packages you want, and the destination folder for the download.

  3. Once the download is complete, open the readme.txt file in the download folder. Follow the instructions in that readme file to install the support packages.

More About

Resolve Common Installation Issues

If you have trouble installing products using mpm, review these common issues that might occur during the installation process:

• If your temporary folder is not writable, you can pass a new writable temporary folder to mpm by using the TMPDIR environment variable. For more details, see the support article Why do I receive a "Permission denied" error when trying to install with the MATLAB Package Manager?

• If your network filters traffic through a proxy server to restrict internet access, you can pass your network's proxy server information to mpm by using the HTTP_PROXY and HTTPS_PROXY environment variables. For more details, see the support article Does the MATLAB Package Manager support proxy servers?

If you continue to have problems, contact support. Provide any error messages, log files, or screenshots related to the problem in your help request. To locate your installation log files, see the support article Where are the log files located for installation, activation, Network License Manager, and the Service Host?