Mathworks Installation Help
Mathworks Installation Help
Installation Help
R2022b
How to Contact MathWorks
Phone: 508-647-7000
iii
Using Installer Properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
iv Contents
1
This procedure is the fastest and easiest for installing to a single computer. You must have a
MathWorks Account, a license linked to that account, and an active Internet connection. If you have
an Activation Key, you can use that instead of your linked license. If you do not have an Internet
connection, follow the instructions in “Install Products Using File Installation Key” on page 1-9.
Consider disabling antivirus software and Internet security applications on your computer during
installation. These applications can slow the installation process or cause it to appear unresponsive
(or to hang).
Installing on Shared Computers You must have the correct permissions to install the software. If
you have questions about permissions, ask your system administrator.
Changing the tmp directory for installation To change the tmp folder for installation, see
MATLAB Answer How can I change the temp directory the MATLAB installer uses?
Linux Users If you plan to run the installer using the root account, see this MATLAB Answer: Why
can't I install MATLAB with the root account in Linux?
If you have Two-Step Verification enabled in your MathWorks Account, you will be prompted to enter
the verification code sent to your primary method when you signed in to your MathWorks Account. If
you do not have Two-Step Verification enabled, you can go directly to the next step.
If you do not have a MathWorks Account, select one of the following procedures determined by your
situation:
1-2
Install Products Using Internet Connection
1 From the Downloads page on the MathWorks website, select the release you want to install and
the platform of the computer that you are installing on.
2 Start the installer. When asked if you want to allow the application to make changes, answer Yes.
3 If your computer has been configured to use a proxy server for Internet access, enter the user
name and password to continue with a standard installation. Contact your system administrator
for proxy server credentials.
If you do not agree with the terms of the license agreement, you will be unable to install MathWorks
products.
If you do not have any licenses listed or you do not see the license you want to use:
• You may need to link a license with your account. See Link a License on the MathWorks website.
• You may be on an organizational license. Follow the steps in "Use an Activation Key" in the next
topic.
If you are using a Student license, accept the Student Use Policy when prompted.
If you are still unsure of what to do, contact your administrator or Contact Support on the MathWorks
website.
If you want to install products on a license that is not linked to your MathWorks Account, ask your
administrator for the Activation Key. The administrator on the license can retrieve the key by going to
the License Center on the MathWorks website. If you are using a trial license, go to https://
www.mathworks.com/licensecenter/trials.
1-3
1 MathWorks Product Installation
During installation, you can activate the software right away and you will not require an Internet
connection (for authentication) when you use MathWorks software thereafter on this computer. The
activation process stores a license file that grants you the right to use the software.
If multiple users are expected to use this computer, or this software is being used in a cloud
environment, you can select to authenticate the software each time it is started. This option requires
each user to sign in to their MathWorks Account to use MATLAB.
MathWorks uses the account information to grant license rights. With this option, MATLAB
periodically checks if the connection to MathWorks is still active. If it cannot detect an active
connection after a certain period of time, it terminates the session.
The destination folder is where you want to install MathWorks products. Accept the default
installation folder, or click Browse to select a different one. If the folder does not exist, the installer
creates it.
The destination folder must be on an absolute path. MathWorks recommends that you install
MathWorks products in their own folder. If you select the top-level drive, you will be asked to confirm
your selections.
• You can use any alphanumeric character and some special characters, such as underscores.
• You cannot use non-English characters.
• Folder names cannot contain invalid characters and the destination cannot be named “private.”
If you make a mistake while entering a folder name and want to start over, click Restore Default.
• To install a particular product, check the box next to its name. MATLAB is selected by default.
• If you do not want to install a particular product, clear the check box next to its name.
• If any of your selected products have a dependency on a product that was not selected, you will
get a Product Dependencies warning and you will be asked to add the dependent products.
1-4
Install Products Using Internet Connection
Dependent products are optional and you can choose to add or not add them. However, while you
are still able to install the selected products without dependent products, you may not be able to
access all the functionality you require.
• Required products must be installed.
• Windows® — You can choose to put shortcuts for starting MATLAB in the Start menu and on the
desktop.
• Linux® — You can specify whether you want to create symbolic links to the matlab and mex
scripts. Specify a folder to which you have write access and that is common to all the user paths
on this computer, such as /usr/local/bin.
When the installation is complete, note if the installer shows you any additional steps required to
complete configuration, and click Finish. If additional steps are required, complete them before
running MATLAB.
1-5
1 MathWorks Product Installation
After you download the installer and products, you can install MathWorks products from the
download location at any time. If you are using a File Installation Key, make sure the downloaded
product files include the installer file and are in a location that an off-network computer can access.
If the target computer is not connected to the Internet, install products following the procedure in
“Install Products Using File Installation Key” on page 1-9.
1 From the Downloads page on MathWorks, select the release and platform of the computer that
you are using to download (not the target computer).
2 Start the installer. When prompted to allow the app to make changes, answer Yes.
3 If prompted again, sign in to your MathWorks Account and accept the MathWorks license
agreement.
4 From the installer, select Advanced Options > I want to download without installing.
• You can use any alphanumeric character and some special characters, such as underscores.
• You cannot use non-English characters.
• Folder names cannot contain invalid characters and the destination cannot be named “private.”
You can select multiple platforms, but note that all platforms are downloaded into the same top level
folder.
1-6
Download Products Without Installing
• To make a particular product available for installation on the target computer, check the box next
to its name. MATLAB is selected by default.
• If you do not want to have a particular product available for installation on the target computer,
clear the check box next to its name.
• If any of your selected products have a dependency on a product that was not selected, you will
get a Product Dependencies warning and you will be asked to add the dependent products.
Dependent products are optional and you can choose to add or not add them. However, while you
are still able to install the selected products without dependent products, you may not be able to
access all the functionality you require.
• Required products must be installed.
When the software is installed, the products available for installation will depend on what is allowed
on the license.
Verify that the folder containing the product files includes the following:
• The installer file for the target platform in the root of the folder:
• Windows— setup.exe
• Linux—install
If you plan to run the installer using the root account, see this MATLAB Answer: Why can't I
install MATLAB with the root account in Linux?
• macOS—InstallForMacOSX
• An archives subfolder
If the archives subfolder contains less than three files, you might be missing required files and
must download the files again.
Next Steps
The procedure you follow depends on whether or not the target computer is connected to the
Internet.
1-7
1 MathWorks Product Installation
• With Internet connection: use the procedure in “Install Products Using Internet Connection” on
page 1-2
• Offline: use the procedure in “Install Products Using File Installation Key” on page 1-9
See Also
Related Examples
• “Install Products Using File Installation Key” on page 1-9
1-8
Install Products Using File Installation Key
• Individual license users: You can get the license file and file installation key from License
Center. See “Prerequisites”.
• Network license administrators and end users:
• Admins can get the license file and file installation key from License Center. See
“Prerequisites”.
• Network license end users can get these items from their license administrator.
You can use this procedure even if you have an Internet connection. You are not required to
disconnect the target computer.
Installing on Shared Computers You must have the correct permissions to install the software. If
you have questions about permissions, ask your system administrator.
Linux Users If you plan to run the update_installer using the root account, see this MATLAB Answer:
Why can't I install MATLAB with the root account in Linux?
Prerequisites
You must perform the following steps before you can install using a file installation key.
Your system must meet certain requirements to run MATLAB. See System Requirements for MATLAB
before performing an installation.
Activate and obtain your license file and get the file installation key using the License Center. If you
are using an organizational license, get the files from your administrator. If you are using a trial
license, go to https://www.mathworks.com/licensecenter/trials.
1 Sign in to your MathWorks Account and click the license you want to use.
2 Go to the Install and Activate tab. If you have not activated a computer for this license yet,
click Activate to activate the license, download the license file, and get the file installation key.
If you have already activated the license, and you have the file installation key, you can click the
download arrow or email icon under Get License File instead.
3 Download and save these items on removable storage (for example, a USB stick).
1-9
1 MathWorks Product Installation
1 Copy the license file and file installation key to the target computer.
Get the product installer and product files using the procedure in “Download Products Without
Installing” on page 1-6. Make sure you follow step 6 for moving the installation files along with the
license file and file installation key to the target computer.
Follow the instructions in the next section to run the installer using a file installation key.
Start the installer. When prompted to allow the app to make changes, answer Yes.
Note Consider disabling antivirus software and Internet security applications on your computer
during installation. These applications can slow the installation process or cause it to appear
unresponsive (or to hang).
Review the software license agreement. If you do not agree with the terms of the license agreement,
you will be unable to install MathWorks products.
• If the product files are not found by the installer, you will get an error before you enter the File
Installation Key. This message includes instructions for downloading the necessary files.
• If you get a message saying that the key is invalid, check to make sure you entered the key
correctly. If necessary, get a new File Installation Key.
• If you get a message saying that the key is invalid for the release you are trying to install, see your
administrator or go to the License Center to get the files for the File Installation Key you have. If
you are using a trial license, go to https://www.mathworks.com/licensecenter/trials.
The license file is required for installation when you use a File Installation Key. It identifies which
products you can run.
1-10
Install Products Using File Installation Key
The destination folder is where you want to install MathWorks products. Accept the default
installation folder, or click Browse to select a different one. If the folder does not exist, the installer
creates it.
The destination folder must be on an absolute path. MathWorks recommends that you install
MathWorks products in their own folder. If you select the top-level drive, you will be asked to confirm
your selections.
• You can use any alphanumeric character and some special characters, such as underscores.
• You cannot use non-English characters.
• Folder names cannot contain invalid characters and the destination cannot be named “private.”
If you make a mistake while entering a folder name and want to start over, click Restore Default.
Changing the tmp directory for installation To change the tmp folder for installation, see
MATLAB Answer How can I change the temp directory the MATLAB installer uses?
The Product Selection list shows all the products associated with the File Installation Key you
specified.
• To install a particular product, check the box next to its name. MATLAB is selected by default.
• If you do not want to install a particular product, clear the check box next to its name.
• If any of your selected products have a dependency on a product that was not selected, you will
get a Product Dependencies warning and you will be asked to add the dependent products.
Dependent products are optional and you can choose to add or not add them. However, while you
are still able to install the selected products without dependent products, you may not be able to
access all the functionality you require.
• Required products must be installed.
Some options are available only for certain license types. If no options are presented to you, you can
go to the next step.
• Windows — You can choose to put shortcuts for starting MATLAB in the Start menu and on the
desktop.
• Linux — You can specify whether you want to create symbolic links to the matlab and mex
scripts. Specify a folder to which you have write access and that is common to all the user paths
on this computer, such as /usr/local/bin.
Review the summary of your installation choices. To change a setting, click the topic on the
navigation bar. To proceed with the installation, click Begin Install.
1-11
1 MathWorks Product Installation
When the installation is complete, note if the installer shows you any additional steps required to
complete configuration, and click Finish. If additional steps are required, complete them before
running MATLAB.
License or System Administrators Only If you run into unrecoverable errors, or if your
organization has complex license mixing issues, consider performing an ISO download instead. See
How do I download a MATLAB ISO archive?
See Also
Related Examples
• “Download Products Without Installing” on page 1-6
1-12
2
It is a good practice to install the network license manager before installing MATLAB. Doing so
makes it easier to verify your MATLAB installations, because you can confirm the client computers
are accessing the license server correctly at the time of installation.
Select a procedure from the Administer Network Licenses category to install and run the network
license manager.
After you have installed the network license manager, select a procedure for installing MATLAB.
• Do not expose the commands to run the network license manager to the Internet or an untrusted
network.
• Start the network license manager so that local administrator access is required to run the
shutdown procedure. .
Users:
2-2
Plan Your Network License Manager Installation and Configuration
See Also
Related Examples
• “Update Network License Manager Software”
• “Administering Network Named User Licenses”
• “Administering Concurrent Licenses”
• “License Requirements for MATLAB on Cloud Platforms”
2-3
2 Install Products on a Network License
In general, you do not need to modify the network license file on the server or on the client
computers. However, in some situations, you must edit the license file:
• When you change the license server name (for example, if the license is now being hosted on a
new server).
• When you change the port number (for example, if the port address for the server has changed).
The following support article contains instructions for migrating MATLAB client installations:
Migrate MATLAB Client Installations to New License Server.
• When you update the network installation with a new license file. See Answer How Do I Update
the License File Used By the License Manager?
• Each INCREMENT line identifies a product, the number of keys available for the product, and other
information. (The INCREMENT lines in your license file might not include every element shown in
the example.)
• The backslash (\) character indicates that the line continues onto the next line.
• The lines that begin with a pound sign (#) are comments. The MathWorks installer uses the
information in these comment lines such as license server host ID or Internet address when it
processes the license file during installation.
# BEGIN---------------BEGIN---------------BEGIN
# MATLAB license passcode file.
# LicenseNo: 123456 HostID: 6C4B905F446E
#
# R2021b
#
INCREMENT MATLAB MLM 46 30-jan-2025 13 FDC7243F4976 \
VENDOR_STRING=vi=0:at=200:ae=1:lu=300:lo=CN:ei=1234567:lr=1:2p=0: \
DUP_GROUP=UH asset_info=123456 ISSUED=21-Nov-2021 BORROW=720 \
NOTICE=product=MATLAB SN=123456 SIGN="00C8 0547 EFDF 50D7 B9CE \
4C9D 3348 561B E9E3 6CCA 7986 C2F6 38C8 794F EE84"
INCREMENT SIMULINK MLM 46 30-jan-2025 1 7DE4D05FF067 \
VENDOR_STRING=vi=0:at=200:ae=1:lu=300:lo=CN:ei=1234567:lr=1:2p=0: \
DUP_GROUP=UH asset_info=123456 ISSUED=21-Nov-2021 BORROW=720 \
NOTICE=product=SIMULINK SN=123456 SIGN="00BE C534 0A32 1821 \
AFCE D040 2085 3E00 9005 4983 7EFB 875F E4A7 FEE6 9548"
2-4
Update or Modify Network License Files
• Makes a copy of the network license file named license.dat, and puts this copy in the /etc
folder of the MATLAB installation folder.
• Adds a SERVER line and a DAEMON line to the file. The SERVER line identifies the server host and
port number. The DAEMON line identifies the name of the network license manager daemon.
• Stores the processed license file in matlabroot/etc, where matlabroot is the MATLAB
installation folder.
• For Network Named User licenses, when the installer creates an options file during installation, it
also adds the Options= syntax to the DAEMON line in your license file. This syntax specifies the
path name of the options file.
For example, if your server is named thunderball and its IP address is 144.212.111.103, the
SERVER and DAEMON lines in your license file would look like this:
• Creates a copy of the license file you specify named network.lic, and puts the file in the
\licenses folder in the MATLAB client installation folder.
• Deletes all the INCREMENT lines and the DAEMON line in the license file, leaving the SERVER line. It
also adds the statement USE_SERVER to the file. This line points the client to the network license
file on the server, which contains all the passcodes for the products.
1 The license file specified on MATLAB startup command line using the -c option. The -c option
overrides the entire search order and uses only what was specified on the command line. This is
the only path MATLAB searches.
2 Environment variables MLM_LICENSE_FILE and LM_LICENSE_FILE.
3 The profile folder of the person starting the program
4 The \licenses folder in the MATLAB installation for files named license.dat or any file with
the extension .lic.
By default, MATLAB installs the license file on the client computer in the \licenses folder in the
MATLAB client installation folder. However, you can override that location in one of either of the
following ways:
• Specify the path to the license file on the command line during MATLAB startup using the -c
option.
The -c option overrides the entire search order, including environment variables, and uses only
what was specified on the command line. This is the only path MATLAB searches.
2-5
2 Install Products on a Network License
You can specify a list of paths to search. When using the -c option, keep in mind the following:
• If the path to your license file contains a space, enclose the path name in quotation marks.
• If you are specifying more than one license file, make sure to enclose the entire list of license
files in quotation marks.
• Set environment variables.
• MLM_LICENSE_FILE — Specifies the location of the license file, but only for MathWorks
products. (Recommended, because it affects only MathWorks products.) MATLAB searches for
this environment variable first.
• LM_LICENSE_FILE — Specifies the location of the license file for all applications using the
network license manager on this server. It is not recommended that you use this environment
variable, as if affects all Flex-enabled products.
You can use one option or the other, but not both.
Note Do not follow this procedure to upgrade to a new release of MATLAB. To upgrade to a later
release, see “Get New MATLAB Release”.
1 Go to the License Center on the MathWorks website and sign in to your account.
2 Select the licenses you want to update.
3 Click Install and Activate.
4 Get the license file for the server you are updating.
5 Stop the network license manager.
6 Open both the existing license on the server and the new license in an editor. You are going to
copy most of the new license into the old license with these instructions:
a In the existing license, delete all content except the SERVER and DAEMON lines at the top
of the file.
b In the new license, copy all content starting from below the SERVER and DAEMON lines to
the end.
c Paste the copied content into the existing license below the SERVER and DAEMON lines.
d Save the existing license. You can store the new license as a backup, remembering that the
SERVER and DAEMON lines must be replaced with those specific to your organization.
7 If you have an options file, depending on how it is configured, you may have to update it. If you
do not have an options file, skip this step.
2-6
Update or Modify Network License Files
You can perform a status inquiry to confirm that the license file has been updated. The following
support article contains instructions for performing a status inquiry: "Monitor the Usage of Licenses
or Keys".
See Also
External Websites
• License Center
2-7
2 Install Products on a Network License
Install Noninteractively
Note You need a File Installation Key to use the installer properties file (installer_input.txt).
For information about installation using a File Installation Key, see “Install Products Using File
Installation Key” on page 1-9.
1 Ensure that the product files, including the MATLAB product installer, are available in an
accessible location; for example, in the default downloads folder on your computer or on a
network share. If the product files are located in a folder other than the default downloads folder
on your computer, the installer file must be located in the same folder as the product files. For
information about downloading product files, see “Download Products Without Installing” on
page 1-6.
2 Create an installer properties file.
Make a copy of the installer properties file template, named installer_input.txt. This file is
located in the top level of the folder where you downloaded the software (typically, C:\Users
\user\AppData\Local\Temp\mathworks_downloads).
destinationFolder=C:\Program Files\MATLAB\R2022b
The installer properties file template contains descriptions of each parameter along with valid
values. Specify your File Installation Key as the value of the fileInstallationKey=
parameter.
4 Save your changes to the file.
5 Start the installer using the -inputFile option to specify the full path of your installer
properties file as a command-line argument.
For example, on Windows computers, click the Start menu and select the Run option. In the Run
dialog box, enter:
2-8
Install Noninteractively
For information about specifying an installer properties file on Linux and macOS computers, see
the instructions in the installer properties file template (installer_input.txt).
2-9
2 Install Products on a Network License
Note If you arrived at this topic because of the error "Network License File Required" and you have
already linked the network license to your MathWorks Account, contact your administrator to get a
copy of the network license file, and then return to the installer.
Select a Procedure
Consult the following table to determine which procedure to use.
When to use: You are asked to perform this installation only one time and do not
expect to be installing updates and upgrades yourself. If your computer is offline,
you must use this option.
Administrato “Have Others Install Software”
r
When to use: When you want the MATLAB user or a member of staff to perform the
installation.
“Administrator Installs Software”
When to use: When you plan to perform the client installations yourself.
MATLAB Users
As the user of the software, you have two options for installing MATLAB yourself using a network
license. Your administrator may have a preference as to which procedure you do.
Both options require you to get a license file from your license administrator. This license has been
configured for your organization.
If your computer is offline, you must follow the workflow in Option #2.
1 Contact your administrator to get permission to link the network license to your MathWorks
Account. The administrator will need to give you the network license number and a license file
customized for your organization. Copy this license file to the machine where you are planning to
install MATLAB.
2 Using the network license number, link the network license to your MathWorks Account. For
instructions, go to License Center.
2-10
Have End Users Install Products
If you select this option, you can follow the online installation procedure as documented in “Install
Products Using Internet Connection” with the following difference:
During the online installation, when prompted, specify the network license linked to your account.
The installer recognizes it as a network license and prompts you for the license file. Enter the path to
the license file and click Next to continue installing.
Option #2: Use License File and File Installation Key to Install
For this workflow, your computer can be connected to the Internet or offline. If your machine is
offline, you must use this workflow.
1 Contact your administrator to get a license file, one that has been configured specifically for your
organization, and a file installation key (FIK).
2 Copy the license file to the machine where you are planning to install MATLAB.
3 Start the installer. If you did not download the installer, ask the administrator if they put the
installer and product files in an accessible place.
4 After you start the installer, from Advanced Options, select I have a File Installation Key.
5 Follow all prompts to finish installing the software.
If you have questions about this process, see “Install Products Using File Installation Key”.
Administrators
You may want your users to install MathWorks software themselves, you may want to assign other
staff to do it for you, or you may choose to perform the installation yourself.
1 Decide if you want the person performing the installation to download and run the installer
themselves, or if you want to download the installer and put it and the product files somewhere
accessible to the person doing the installation. For the latter, see “Download Products Without
Installing”.
2 Give users a copy of the MathWorks license file that was processed during installation of the
network license manager on your server. This license file must contain the correct SERVER line
for the license server you are using. See “License Processing During MATLAB Installation” on
page 2-4.
Note Do not give users a copy of the original license file you received in the licensing email.
They cannot use the licensing information in this form — it does not include the correct SERVER
line. Also, do not forward to users the licensing email you received from MathWorks.
3 • If the user wants to link the license to their account, give them the license number also.
• If they are going to follow the offline workflow, give them the FIK also. You can get the FIK
from License Center:
Go to the Install and Activate tab. Click Advanced Options. Select the release or verify the
release selected and then click Done. You will get both a license file and activation key, but as
noted previously, give the user the processed license file, not the one from this procedure.
2-11
2 Install Products on a Network License
4 For either option, have the person follow the instructions in “MATLAB Users”.
If you - the administrator - are going to install the software, you can select any of the following
procedures:
• “Install Products Using Internet Connection”- For this workflow, you must have a MathWorks
Account with the network license and a copy of your organization's MathWorks license file.
• “Download Products Without Installing” and “Install Products Using File Installation Key” - For
this workflow, you need both the license file and and a FIK.
• “Install Noninteractively”.
See Also
Related Examples
• “Plan Your Network License Manager Installation and Configuration” on page 2-2
• “Install Products Using Internet Connection” on page 1-2
• “Install Products Using File Installation Key” on page 1-9
2-12
Activate MATLAB Installation Manually
Activation Overview
Activation is a process that verifies licensed use of MathWorks products. This process validates the
license and ensures that it is not used on more computers or by more users than allowed by the
license option you selected. Normally, activation is performed during installation, and there is no
separate action for the end user.
However, there may be occasions to manually activate the software, for example, if the activation
during installation fails for some reason, or if the installation was performed using a File Installation
Key and no license was supplied.
This topic describes how to activate the software manually should you need to.
You can follow these procedures also if you are an end user who has been asked to activate MATLAB
software that was not installed by you.
• To perform an online activation from within MATLAB, the computer must be connected to the
Internet.
• To perform an offline activation from within MATLAB, you must have a license file.
• If you are using an individual license, use an online machine to go to License Center to get the
license file (if you don't know what type of license you have, you can find that out in License
Center).
1 On the Home tab, in the Resources section, click Help > Licensing.
2 Select Activate Software.
• Windows Systems — in the search box on the taskbar, enter "Activate" to bring up the Activate
MATLAB application.
• macOS Systems — Double-click the activation application icon in the MATLAB application
package. To view the contents of the MATLAB application package, right-click (or Ctrl+click) the
package and select Show Package Contents.
2-13
2 Install Products on a Network License
• Navigate to your MATLAB installation folder and open the activation application.
Note The license file (offline) workflow is started automatically if the computer is offline. However, if
the computer is connected to the Internet, it starts the online workflow.
• To switch to the license file workflow, from Advanced Options, select I want to use a
license file.
• To switch from the license file workflow to the online workflow, from Advanced Options, select I
want to link to a license.
Online Workflow
1 Enter the email address you use for your MathWorks Account.
If you do not have a MathWorks Account, you can create one at this time.
2 Select a license from the list of licenses linked with your MathWorks Account and then click
Next.
3 Make sure the selections are correct and then click Activate.
1 If you are prompted for your email address, under Advanced Options, select I want to use
a license file.
2 Enter the path to the license file and then click Activate.
What's Next?
You are now ready to begin using MathWorks software.
2-14
3
Install and run the network license manager for Network Named User and Concurrent licenses.
3 Install Network License Manager
You must install the license manager and have it running before you install MATLAB software on
client systems. For information about installing MathWorks software on client systems, see “Plan Your
Network License Manager Installation and Configuration” on page 2-2.
You need to install the network license manager only one time at a site.
Whichever option you selected, remember to save the license file to the server where you will be
installing the network license manager.
Click Continue.
For this workflow, you can skip steps 2 and 3 in License Center and continue following these
instructions.
• Windows Systems
If you click Run when you select the installer on the MathWorks website, the installer starts
automatically. If you saved the installer instead, double-click the self-extracting installer file in
3-2
Install Network License Manager Offline
the folder where you saved it. The name of the self-extracting installer file is
matlab_release_$ARCH, where release is the release you are installing (for example
R2020a) and $ARCH is the selected architecture.
To restart the installer later, click setup.exe. This file is located in the top level of the folder
where you extracted the files.
• macOS Systems
Double-click the dmg file that you downloaded from the MathWorks website. Double-click
InstallForMacOSX.app.
• Linux Systems
Use the unzip command to extract the files from the archive file that you downloaded from
the MathWorks website. After extracting the files, execute the installer command:
./install
Note To view the end user license agreement at any time after installation, execute the following
command in the MATLAB Command Window:
If the installer cannot find the host ID in the license, you will get a message instructing you to
manually add the host ID after you finish installing.
The destination folder must be on an absolute path. MathWorks recommends that you install the
network license manager in its own folder. If you select the top-level drive, you will be asked to
confirm your selection.
• You can use any alphanumeric character and some special characters, such as underscores.
• You cannot use non-English characters.
3-3
3 Install Network License Manager
• Folder names cannot contain invalid characters and the destination cannot be named “private.”
If you make a mistake while entering a folder name and want to start over, click Restore Default.
To review the default network license manager configuration settings, click View Default Settings.
If you choose not to configure the network license manager service, you can do it later.
Note If you have an existing network license manager that you want to continue to use until you
install the new one, do not check Configure as service. The installer still installs the network license
manager files. After installation, you can stop your existing license manager and start your new
license manager.
When the installation is complete, note if the installer shows you any additional steps required to
complete configuration, and click Close. If additional steps are required, complete them before
installing and running MATLAB on client machines.
See Also
Related Examples
• “Plan Your Network License Manager Installation and Configuration” on page 2-2
3-4
Install Network License Manager Using Internet Connection
Install the network license manager on a computer connected to the internet. You must install the
license manager and have it running before you install MATLAB software on client systems. See “Plan
Your Network License Manager Installation and Configuration” on page 2-2.
You need to install the network license manager only one time at a site.
Whichever option you selected, remember to save the license file to the server where you will be
installing the network license manager.
Click Continue.
For this workflow, you can skip steps 2 and 3 in License Center and continue following these
instructions.
When you select an installer on the website, you receive the files that the installer needs to run
on your selected platform, not the license manager files. The installer downloads the files that it
needs from MathWorks during installation.
2 Start the installer.
• Windows Systems
If you click Run when you select the installer on the MathWorks website, the installer starts
automatically. If you saved the installer instead, double-click the self-extracting installer file in
the folder where you saved it. The name of the self-extracting installer file is
matlab_release_$ARCH, where release is the release you are installing (for example
R2020a) and $ARCH is the selected architecture.
3-5
3 Install Network License Manager
To restart the installer later, click setup.exe. This file is located in the top level of the folder
where you extracted the files.
• macOS Systems
Double-click the dmg file that you downloaded from the MathWorks website. Double-click
InstallForMacOSX.app.
• Linux Systems
Use the unzip command to extract the files from the archive file that you downloaded from
the MathWorks website. After extracting the files, execute the installer command:
./install
3 When the installer prompts you to sign in, click Advanced Options > I want to install network
license manager.
Review the software license agreement and, if you agree with the terms, select Yes and click Next.
Note To view the end user license agreement at any time after installation, execute the following
command in the MATLAB Command Window:
>> edit( fullfile(matlabroot, 'license_agreement.txt') )
If the installer cannot find the host ID in the license, you will get a message instructing you to
manually add the host ID after you finish installing.
The destination folder is where you want to install the network license manager. Accept the default
installation folder, or click Browse to select a different one. If the folder does not exist, the installer
creates it.
The destination folder must be on an absolute path. MathWorks recommends that you install the
network license manager in its own folder. If you select the top-level drive, you will be asked to
confirm your selection.
• You can use any alphanumeric character and some special characters, such as underscores.
• You cannot use non-English characters.
• Folder names cannot contain invalid characters and the destination cannot be named “private.”
If you make a mistake while entering a folder name and want to start over, click Restore Default.
3-6
Install Network License Manager Using Internet Connection
To review the default network license manager configuration settings, click View Default Settings.
If you choose not to configure the network license manager service, you can do it later.
Note If you have an existing network license manager that you want to continue to use until you
install the new one, do not check Configure as service. The installer still installs the network license
manager files. After installation, you can stop your existing license manager and start your new
license manager.
When the installation is complete, note if the installer shows you any additional steps required to
complete configuration, and click Close. If additional steps are required, complete them before
installing and running MATLAB on client machines.
See Also
Related Examples
• “Plan Your Network License Manager Installation and Configuration” on page 2-2
3-7
3 Install Network License Manager
To avoid any potential issues with license file operation, consider upgrading the network license
manager software whenever you upgrade MATLAB software.
• Linux and macOS Systems — Use the lmdown command. For additional information, see “Using
Command-Line Utilities”.
• Windows Systems — Remove the existing service to prevent any conflicts.
If you already have the network license manager installed and configured, you can download new
network license manager daemons directly to your server instead of using the MathWorks installer to
install the latest version of the software. The license manager daemons include:
3-8
Update Network License Manager Software
See Also
Related Examples
• “Start Network License Manager”
• “Monitor Network License Manager”
3-9