Installing without the Setup program (offline installation)
ModusToolbox™ software consists of many packages and packs that can be downloaded and installed individually. In some cases, you may not want to use the Setup program to install the ModusToolbox™ software. We refer to this as "offline installation." You need to download and install the packages you want, or install them with the Infineon Developer Center (IDC) locally or on the web. Just be aware that some ModusToolbox™ packages have dependencies on others. So, you’ll have to install dependencies as well.
Tools package
To properly install ModusToolbox™ software, start by downloading and installing the tools package. This contains the build support, tools, configurators, etc.
To download it separately, go to
https://softwaretools.infineon.com/tools/com.ifx.tb.tool.modustoolbox
and click Download.
To use the IDC, go to
, look for ModusToolbox™ Tools Package, and click Install.
The ModusToolbox™ tools package default installation location for each OS is as follows:
Windows:
C:\Users<user-home>\ModusToolbox\
macOS:
/Applications/ModusToolbox/
Linux:
/opt/tools/ModusToolbox/
If your default installation directory contains spaces or illegal characters, or if you want to install the ModusToolbox™ tools package in a non-default location, see the
Custom installation
section later in this document.
Windows
Run the
ModusToolbox_3.4.0.<build>-windows-install.exe
installer program and follow the prompts to install for the current user only and then accept the license agreement.

The installer for Windows provides options to install for the current user or for all users of the same computer. Depending on if you have administration privileges or not, you may be asked to enter a password.
Note:
If you select "Install for all users" and then later select install for the current user, the Windows "Apps & features" setting will list only one instance of the ModusToolbox™ installation. Use the uninstaller to point to the type of installation (All Users or Current User), depending on the order they were installed. To see all installations, navigate to
Control Panel > Programs and Features
.
On the next screen select
Quick Installation
and click
Install
.
Note:
If you have not installed the ModusToolbox™ tools package previously, you may be prompted to restart your computer due to installation of Microsoft Visual C++ redistributable files.
Linux
Navigate to the location of the *.
deb
file and type the following command:
$ sudo apt install ./ModusToolbox_3.4.0.<build>-linux-install.deb
Note:
Use the apt tool instead of dpkg to resolve dependencies and avoid installation errors of installing the IDC Launcher Service as a nested package.
Then, run the following to initialize the
CY_TOOLS_PATHS
environment variable defined in the
/etc/profile.d/modustoolbox_3.4.sh
file:
$ bash –-login
Finally, log out and then log back in to ensure the variable is acknowledged by the system.
Note:
To install ModusToolbox software to run on WSL, refer to Application Note
AN238846: Running ModusToolbox™ using Windows Subsystem for Linux (WSL).
macOS
Double-click the downloaded
ModusToolbox_3.4.0.<build>-osx-install.pkg
file and follow the wizard. The installer only allows installation for all users.
The ModusToolbox™ tools package will be installed under the
Applications
folder in the volume you select in the wizard.
Note:
The ModusToolbox™ tools package installer also installs a custom USB driver for use with ModusToolbox™ software on macOS versions prior to Catalina. It may pop up a "System Extension Blocked" dialog. In this case, go to
Security Preference
and click
Allow
for the driver to be installed.
Xcode for macOS
In order for ModusToolbox™ software to work correctly on macOS, you must also install an additional Xcode package if you don’t already have it installed. We recommend you install Xcode using the following command in a terminal window:
xcode-select --install
Note:
You may install Xcode from the App Store, but it will likely consume much more disk space than using the above command.
Dependencies
After installation of the tools package is complete, you need to install dependencies. The first is the ModusToolbox™ Programming tools package to get various tools like firmware loader, openOCD, etc.
To download it separately, go to
https://softwaretools.infineon.com/tools/com.ifx.tb.tool.modustoolboxprogtools
and click Download.
To use the IDC, click Install via Launcher or go to
, look for ModusToolbox™ Programming tools, and click Install.
The next dependency package to install is the ModusToolbox™ Edge Protect Security Suite to get security and provisioning tools.
To download it separately, go to
https://softwaretools.infineon.com/tools/com.ifx.tb.tool.modustoolboxedgeprotectsecuritysuite
and click Download.
To use the IDC, click Install via Launcher or go to
, look for ModusToolbox™ Edge Protect Security Suite, and click Install.
IDEs
The ModusToolbox™ ecosystem supports command line operations, as well as four IDEs: Visual Studio Code, Eclipse, IAR Embedded Workbench, and Keil µVision (arm MDK). To use the command line, refer to the
tools package user guide
. To use a supported IDE, refer to the applicable user guide: