Install and Configure the MATLAB Runtime

Download the MATLAB Runtime Installer from the Web

Download the MATLAB® Runtime from the website at https://www.mathworks.com/products/compiler/matlab-runtime.html.

Install the MATLAB Runtime Interactively

To install the MATLAB^® Runtime:

Unzip/Extract the archive containing the MATLAB Runtime installer.

Platform Steps

Platform	Steps
Windows^®	Unzip the MATLAB Runtime installer. To unzip the installer: Right click the zip file `MATLAB_Runtime_R2020b_win64.zip` Select Extract All, and then follow the instructions.
Linux^®	Unzip the MATLAB Runtime installer at the terminal using the `unzip` command. For example, if you are unzipping the R2020b MATLAB Runtime installer, at the Terminal, type: unzip MATLAB_Runtime_R2020b_glnxa64.zip
macOS	Unzip the MATLAB Runtime installer at the terminal using the `unzip` command. For example, if you are unzipping the R2020b MATLAB Runtime installer, at the Terminal, type: unzip MATLAB_Runtime_R2020b_maci64.zip

Windows^®

Unzip the MATLAB Runtime installer. To unzip the installer:

Right click the zip file MATLAB_Runtime_R2020b_win64.zip
Select Extract All, and then follow the instructions.

Linux^®

Unzip the MATLAB Runtime installer at the terminal using the unzip command.

For example, if you are unzipping the R2020b MATLAB Runtime installer, at the Terminal, type:

unzip MATLAB_Runtime_R2020b_glnxa64.zip

macOS

Unzip the MATLAB Runtime installer at the terminal using the unzip command.

For example, if you are unzipping the R2020b MATLAB Runtime installer, at the Terminal, type:

unzip MATLAB_Runtime_R2020b_maci64.zip

Note

The release part of the installer filename (_R2020b_) will change from one release to the next.

Start the MATLAB Runtime installer.

Platform Steps

Windows

Platform	Steps
Windows	Double-click the file `setup.exe` from the extracted files to start the installer.
Linux	At the Terminal, type: sudo ./install Note On Debian^® based Linux distributions, you will need to type: gksudo ./install
macOS	At the Terminal, type: ./install Note You may need to enter an administrator username and password after you run `./install`.

Double-click the file setup.exe from the extracted files to start the installer.

Linux

At the Terminal, type:

sudo ./install

Note

On Debian^® based Linux distributions, you will need to type:

gksudo ./install

macOS

At the Terminal, type:

./install

Note

You may need to enter an administrator username and password after you run ./install.

When the MATLAB Runtime installer starts, it displays a dialog box. Read the information and then click Next to proceed with the installation.
Specify the folder in which you want to install the MATLAB Runtime in the Folder Selection dialog box.
Note
On Windows systems, you can have multiple versions of the MATLAB Runtime on your computer but only one installation for any particular version. If you already have an existing installation, the MATLAB Runtime installer does not display the Folder Selection dialog box because you can only overwrite the existing installation in the same folder.
Confirm your choices and click Next.
The MATLAB Runtime installer starts copying files into the installation folder.
On Linux and macOS platforms, after copying files to your disk, the MATLAB Runtime installer displays the Product Configuration Notes dialog box. This dialog box contains information necessary for setting your path environment variables. Copy the path information from this dialog box and then click Next.
Click Finish to exit the installer.

Install the MATLAB Runtime Non-Interactively

To install the MATLAB Runtime without having to interact with the installer dialog boxes, use one of the MATLAB Runtime installer’s non-interactive modes:

silent—the installer runs as a background task and does not display any dialog boxes
automated—the installer displays the dialog boxes but does not wait for user interaction

When run in silent or automated mode, the MATLAB Runtime installer uses default values for installation options. You can override these defaults by using MATLAB Runtime installer command-line options or an installer control file.

Note

When running in silent or automated mode, the installer overwrites the default installation location.

Running the Installer in Silent Mode

To install the MATLAB Runtime in silent mode:

Extract the contents of the MATLAB Runtime installer file to a temporary folder, called $temp in this documentation.
Note
On Windows systems, manually extract the contents of the installer file.

Run the MATLAB Runtime installer, specifying the -mode option and -agreeToLicense yes on the command line.

Note

On most platforms, the installer is located at the root of the folder into which the archive was extracted. On Windows 64, the installer is located in the archives bin folder.

Platform	Command
Windows	`setup -mode silent -agreeToLicense yes`
Linux	`./install -mode silent -agreeToLicense yes`
macOS	`./install -mode silent -agreeToLicense yes`

Note

If you do not include the -agreeToLicense yes the installer will not install the MATLAB Runtime.

View a log of the installation.
On Windows systems, the MATLAB Runtime installer creates a log file, named mathworks_username.log, where username is your Windows log-in name, in the location defined by your TEMP environment variable.
On Linux and macOS systems, specify the path variable. The MATLAB Runtime installer displays the log information for Linux and macOS systems at the command prompt, unless you redirect it to a file.

Customizing a Non-Interactive Installation

When run in one of the non-interactive modes, the installer will use the default values unless told to do otherwise. Like the MATLAB installer, the MATLAB Runtime installer accepts a number of command line options that modify the default installation properties.

Option	Description
`-destinationFolder`	Specifies where the MATLAB Runtime will be installed.
`-outputFile`	Specifies where the installation log file is written.
`-automatedModeTimeout`	Specifies how long, in milliseconds, that the dialog boxes are displayed when run in automatic mode.
`-inputFile`	Specifies an installer control file with the values for all of the above options.

Note

The MATLAB Runtime installer archive includes an example installer control file called installer_input.txt. This file contains all of the options available for a full MATLAB installation. Only the options listed in this section are valid for the MATLAB Runtime installer.

Install the MATLAB Runtime without Administrator Rights

To install the MATLAB Runtime as a user without administrator rights on Windows:

Use the MATLAB Runtime installer to install it on a Windows machine where you have administrator rights.
Copy the folder where the MATLAB Runtime was installed to the machine without administrator rights. You can compress the folder into zip file and distribute to multiple users.
On the machine without administrator rights, add the mcr_root\runtime\arch directory onto the user’s path environment variable.
Note
You don’t need administrator rights for adding directories to a user’s path environment variable.

Multiple MATLAB Runtime Versions on Single Machine

MCRInstaller supports the installation of multiple versions of the MATLAB Runtime on a target machine. This allows applications compiled with different versions of the MATLAB Runtime to execute side by side on the same machine.

If you do not want multiple MATLAB Runtime versions on the target machine, you can remove the unwanted ones. On Windows, run Add or Remove Programs from the Control Panel to remove any of the previous versions. On Linux, you manually delete the unwanted MATLAB Runtime. You can remove unwanted versions before or after installation of a more recent version of the MATLAB Runtime, as versions can be installed or removed in any order.

MATLAB and MATLAB Runtime on Same Machine

To test your deployed component on your development machine you do not need an installation of MATLAB Runtime. The MATLAB installation used to compile the component can act as the MATLAB Runtime replacement.

You can, however, install the MATLAB Runtime for debugging purposes.

Modifying the Path

If you install MATLAB Runtime on a machine that already has MATLAB on it, you must adjust the library path according to your needs.

Windows
To run deployed MATLAB code against MATLAB Runtime install, mcr_root\ver\runtime\win64 must appear on your system path before matlabroot\runtime\win64.
If mcr_root\ver\runtime\arch appears first on the compiled application path, the application uses the files in the MATLAB Runtime install area.
If matlabroot\runtime\arch appears first on the compiled application path, the application uses the files in the MATLAB installation area.
Linux
To run deployed MATLAB code against MATLAB Runtime on Linux, the folder <mcr_root>/runtime/<arch> must appear on your LD_LIBRARY_PATH before matlabroot/runtime/<arch>.
macOS
To run deployed MATLAB code on macOS, the <mcr_root>/runtime folder must appear on your DYLD_LIBRARY_PATH before matlabroot/runtime/<arch>.
To run MATLAB on macOS or Intel^® Mac, matlabroot/runtime/<arch> must appear on your DYLD_LIBRARY_PATH before the <mcr_root>/bin folder.

Uninstall MATLAB Runtime

The method you use to uninstall MATLAB Runtime from your computer varies depending on the type of computer.

Windows

Start the uninstaller.
From the Windows Start menu, search for the Add or Remove Programs control panel, and double-click MATLAB Runtime in the list.
You can also start the MATLAB Runtime uninstaller from the mcr_root\uninstall\bin\arch folder, where mcr_root is your MATLAB Runtime installation folder and arch is an architecture-specific folder, such as win64.
Select the MATLAB Runtime from the list of products in the Uninstall Products dialog box.
Click Next.
Click Finish.

Linux

Exit the application.
Enter this command at the Linux prompt:
```
rm -rf mcr_root
```
where mcr_root represents the name of your top-level MATLAB installation folder.

macOS

Exit the application.
Navigate to your MATLAB Runtime installation folder. For example, the installation folder might be named MATLAB_Compiler_Runtime.app in your Applications folder.
Drag your MATLAB Runtime installation folder to the trash, and then select Empty Trash from the Finder menu.

Documentation