Download and Install MATLAB Runtime
Supported Platforms: Windows®, Linux®, macOS
MATLAB® Runtime contains the libraries needed to run compiled MATLAB applications on a target system without a licensed copy of MATLAB. For more information, see About MATLAB Runtime.
Download MATLAB Runtime Installer
Download the MATLAB Runtime installer using one of the following options:
Download the MATLAB Runtime installer at the latest update level for the selected release from the website athttps://www.mathworks.com/products/compiler/matlab-runtime.html. This option is best for end users who want to run deployed applications.
Use the MATLAB function compiler.runtime.download to download the MATLAB Runtime installer matching the version and update level of MATLAB from where the command is executed. If the installer has already been downloaded to the machine, it returns the path to the MATLAB Runtime installer. If the machine is offline, it returns a URL to the MATLAB Runtime installer. This option is best for developers who want to create application installers that contain MATLAB Runtime.
Use the MATLAB function compiler.runtime.customInstaller to create a MATLAB Runtime installer that installs only the MATLAB Runtime components required to run the specified artifacts created with MATLAB Compiler™ or MATLAB Compiler SDK™. This option is best for developers who require an installer with a minimal size footprint that can only run specific applications. (since R2024b)
Note
If you want to install MATLAB Runtime to a shared network drive, see Deploy Applications and MATLAB Runtime on Network Drives.
Install MATLAB Runtime Interactively
To install MATLAB Runtime:
Extract the archive containing the MATLAB Runtime installer. The release part of the installer file name (
_R2024b_
) changes from one release to the next.Platform Steps Windows Unzip the MATLAB Runtime installer.
Right-click the ZIP file
MATLAB_Runtime_R2024b_win64.zip
and select Extract All.Linux Unzip the MATLAB Runtime installer at the terminal using the
unzip
command.For example, if you are unzipping the R2024b MATLAB Runtime installer, at the terminal, type:
unzip MATLAB_Runtime_R2024b_glnxa64.zip
macOS
Unzip the MATLAB Runtime installer at the terminal using the
unzip
command.For Intel® processor-based macOS, type:
unzip MATLAB_Runtime_R2024b_maci64.zip
For Apple silicon-based macOS, type:
unzip MATLAB_Runtime_R2024b_maca64.zip
Start the MATLAB Runtime installer.
Platform Steps Windows Double-click the file
setup.exe
from the extracted files to start the installer.Linux At the terminal, type:
sudo -H ./install
sudo
is only required if you install to a directory that you do not have write access to.Note
You may need to allow the root user to access the running X server:
xhost +SI:localuser:rootsudo -H ./installxhost -SI:localuser:root
macOS
Double-click the DMG file to start the installer.
When the MATLAB Runtime installer starts, it displays a dialog box. Read the information and then click Next to proceed with the installation.
In the Folder Selection dialog box, specify the folder where you want to install MATLAB Runtime.
You can have multiple versions of MATLAB Runtime on your computer, but only one installation for any particular version. If you have an existing installation of the same version, the MATLAB Runtime installer does not display the Folder Selection dialog box because it overwrites 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, save it to a text file, and then click Next.
For instructions on setting the path environment variables, see Set MATLAB Runtime Path for Deployment.
Click Finish to exit the installer.
Default Install Folder
The default MATLAB Runtime installation folders for R2024b are specified in the following table:
Platform | MATLAB Runtime Installation Folder |
---|---|
Windows | C:\Program Files\MATLAB\MATLAB Runtime\R2024b |
Linux | /usr/local/MATLAB/MATLAB_Runtime/R2024b |
macOS | /Applications/MATLAB/MATLAB_Runtime/R2024b |
Install MATLAB Runtime Noninteractively
Supported platforms: Windows, Linux
If you have many installations to perform, you can specify installation arguments as command-line arguments or in an installer control file to save time and prevent errors. When you specify installation arguments, the MATLAB Runtime installer runs as a background task and does not display any dialog boxes.
When running noninteractively, the installer overwrites the installation location.
Caution
On Linux, the installer displays information necessary for setting your environment variables in the Product Configuration Notes dialog box. If you use the installer noninteractively, you must locate your MATLAB Runtime installation directory in order to set the library path after installation. For more information, see Set MATLAB Runtime Path for Deployment.
Run Installer in Silent Mode
To install MATLAB Runtime in silent mode:
Extract the contents of the MATLAB Runtime installer archive to a temporary folder.
In your system command prompt, navigate to the folder where you extracted the installer.
Run the MATLAB Runtime installer, specifying the
-agreeToLicense yes
option on the command line. If you do not include-agreeToLicense yes
as the first option, the installer will not install MATLAB Runtime.Note
On most platforms, the installer is located at the root of the folder into which the archive was extracted. On 64-bit Windows, the installer is located in the archive
bin
folder.Platform Command Windows setup -agreeToLicense yes
Linux sudo ./install -agreeToLicense yes
Note
sudo
is only required if you install to a directory you do not have write access to.Note
To install MATLAB Runtime R2022a and earlier, you must also specify
-mode silent
in the command to run the installer in silent mode.View a log of the installation.
On Windows systems, the installer creates a log file named
mathworks_
, whereusername
.logusername
is your Windows login name, in the location defined by yourTEMP
environment variable.On Linux, the installer displays the log information at the command prompt. It also saves it to a file if you use the
-outputFile
option.
Customize Noninteractive Installation
When run noninteractively, the installer uses the default values unless you specify otherwise. Like the MATLAB installer, the MATLAB Runtime installer accepts a number of options that modify the default installation properties.
Create an installer control text file that contains your command-line options and values. Omit the dash before each option and put each option and value pair on a separate line. For example:
agreeToLicense=yesdestinationFolder=/usr/MATLAB/MATLAB_RuntimeoutputFile=myapp_log.txt
Then, specify the file using the -inputfile
argument. For example, on Linux:
./install -inputfile installer_input.txt
You can specify the following options in the installer input file.
Option | Description |
---|---|
-agreeToLicense | Agree to the MATLAB Runtime license. |
-destinationFolder | Specifies where MATLAB Runtime is installed. If the user does not have write access to the folder, you must run the installer with administrator privileges. |
-outputFile | Specifies where the installation log file is written. |
Note
The MATLAB installer archive includes an example installer control file called installer_input.txt
, which contains all of the options available for a full MATLAB installation. However, the MATLAB Runtime installer only accepts the options listed in this section.
Install MATLAB Runtime without Administrator Rights
On Linux, to install MATLAB Runtime without sudo
privileges, select a folder that you have write access to during installation.
On Windows, to install MATLAB Runtime as a user without administrator rights:
Install MATLAB Runtime on a Windows machine where you have administrator rights.
Copy the folder where MATLAB Runtime was installed to the machine without administrator rights. You can compress the folder into a zip file for distribution.
On the machine without administrator rights, add the
directory to the user’s<MATLAB_RUNTIME_INSTALL_DIR>
\runtime\arch
PATH
environment variable. For more information, see Set MATLAB Runtime Path for Deployment.
Install Multiple MATLAB Runtime Versions on Single Machine
MCRInstaller
supports the installation of multiple versions of MATLAB Runtime on a target machine. This capability allows applications compiled with different versions of 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 a specific version. On Linux, manually delete the unwanted MATLAB Runtime directories. You can remove unwanted versions before or after installation of a more recent version of MATLAB Runtime because versions can be installed or removed in any order.
Note
Installing multiple versions of MATLAB Runtime on the same machine is not supported on macOS.
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 that you use to compile the component can act as a MATLAB Runtime replacement.
You can install MATLAB Runtime for debugging purposes.
Modify Path
If you install MATLAB Runtime on a machine that already has MATLAB on it, you must adjust the system library path according to your needs.
To run deployed MATLAB code against MATLAB Runtime rather than MATLAB, ensure that your library path lists the MATLAB Runtime directories before any MATLAB directories. For information on setting environment variables, see Set MATLAB Runtime Path for Deployment.
Alternatively, you can specify the location of MATLAB Runtime using the generated shell script for your compiled application.
Uninstall MATLAB Runtime
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
<MATLAB_RUNTIME_INSTALL_DIR>
\bin\
folder, where<arch>
is your MATLAB Runtime installation folder and<MATLAB_RUNTIME_INSTALL_DIR>
is an architecture-specific folder, such as<arch>
win32
orwin64
.Select MATLAB Runtime from the list of products in the Uninstall Products dialog box and click Next.
Click Finish.
Linux
Close all instances of MATLAB and MATLAB Runtime.
Enter this command at the Linux terminal:
rm -rf <MATLAB_RUNTIME_INSTALL_DIR>
Caution
Be careful when using the
rm
command, as deleted files cannot be recovered.
macOS
Close all instances of MATLAB and MATLAB Runtime.
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.
See Also
compiler.runtime.download
Related Topics
- About MATLAB Runtime
- MATLAB Runtime Startup Options
- Set MATLAB Runtime Path for Deployment
- MATLAB Runtime Container
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- Deutsch
- English
- Français
- United Kingdom (English)
Contact your local office