Install Deployed Application
After you create an installer for your compiled application, you can install it interactively using a graphical interface or noninteractively using command-line arguments.
Install Application Interactively
Complete the following steps according to your operating system to install the
application my_app
interactively using
MyAppInstaller
.
Start the installer.
Platform Steps Windows® Double-click the file
MyAppInstaller.exe
.Linux® In the terminal, type:
sudo -H ./MyAppInstaller
Note
The
-H
option sets theHOME
environment variable to the home directory of the root user and should be used for graphical applications.macOS
In the terminal, type:
./MyAppInstaller
Note
You may need to enter an administrator username and password after you run
./MyAppInstaller
.If you want to connect to the Internet using a proxy server, click Connection Settings. Enter the proxy server settings in the provided window and click OK. Click Next.
Choose the installation folder for the application. To create a desktop shortcut, check the box labeled Add a shortcut to the desktop. Click Next.
If MATLAB® Runtime is not already installed on your machine, choose the installation folder for the MATLAB Runtime libraries and click Next.
Select Yes to accept the terms of the MATLAB Runtime license agreement and click Next.
Click Install > to begin the installation.
On Linux and macOS platforms, after copying files to your disk, the 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 information on setting environment variables, see Set MATLAB Runtime Path for Deployment.
Click Finish to exit the installer.
If you accepted the default settings, you can find the installed application in one of the following locations:
Windows C:\Program Files\my_app
macOS /Applications/my_app
Linux /usr/my_app
Install Application Noninteractively
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.
To install an application without having to interact with the installer dialog boxes, use one of the following noninteractive 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.
Caution
On Linux and macOS systems, the installer displays information necessary for setting your environment variables in the Product Configuration Notes dialog box. If you use the installer in automated or silent mode, 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.
Note
When running in silent or automated mode, the installer overwrites the installation location.
Run Installer in Silent Mode
To install the application in silent mode:
Run the installer on the command line and specify the options
-mode silent
and-agreeToLicense yes
.Platform Command Windows MyAppInstaller.exe -agreeToLicense yes -mode silent
Linux ./MyAppInstaller -agreeToLicense yes -mode silent
macOS ./MyAppInstaller -agreeToLicense yes -mode silent
Note
If you do not include
-agreeToLicense yes
as the first option, the installer will not install the application.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. You can specify a log file using the-outputFile
option.On Linux and macOS systems, the installer displays the log information at the command prompt. If you specify a file using the
-outputFile
option, it also saves the log information to the file.
Customize Noninteractive Installation
When run in one of the noninteractive modes, the installer uses the default values for installation options unless you specify otherwise. Like the MATLAB installer, the application installer accepts a number of command-line options that modify the default installation properties.
To specify options on the command line, separate each option and its value with a space. For example,
./MyAppInstaller -agreeToLicense yes -mode silent
-outputFile myapp_log.txt -desktopShortcut true -startMenuShortcut true
Option | Description | Comment |
---|---|---|
-destinationFolder | Specifies where the application and MATLAB Runtime are installed. | In the destination folder, MATLAB Runtime is installed in a folder named after the version number, for example, v912. |
-outputFile | Specifies where the installation log file is written. | |
-automatedModeTimeout | Specifies how long, in milliseconds, that the dialog boxes are displayed when run in automated mode. | The default value is 1000 milliseconds. |
-desktopShortcut true|false | Specifies whether to create a desktop shortcut icon for the installed application. | The default value is false. This option is only used on Windows. |
-startMenuShortcut true|false | Specifies whether to create a Start Menu shortcut icon for the installed application. | The default value is false. This option is only used on Windows. |
-tmpdir | Specifies where temporary files are stored during installation. | The installer overwrites anything in the directory. |
-inputFile | Specifies an installer control 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 yes mode automated outputFile myapp_log.txt |