STM32CubeIDE installation (macOS®)

This section describes how to install the STM32CubeIDE product on macOS®.

Note: The installation is done through a product installer. Make sure that the user account, from which the installer is launched, has administrative privileges.

Proceed as follows:

1. Launch the product installer ( .dmg file) stm32cubeide_VERSION-Mac-ARCHITECTURE.dmg where:

– VERSION is the actual product version and build date.

Example: 2.2.0_2026_20190221_13091309

– ARCHITECTURE is the architecture of the target host computer to run STM32CubeIDE . Example: x86_64 or aarch64

  1. Read the license agreement. Click on [Agree] to accept the terms of the agreement, or [Disagree] to abort the installation. If the agreement is accepted, the installation wizard continues.

Figure 8. License agreement dialog (macOS®)

Reset perspective
  1. Wait for the installation welcome page to appear.

  2. Double click on the .pkg file indicated with the curved arrow and text stating “Install me 1st”.

Figure 9.Installation welcome page (macOS®)

Reset perspective
  1. This installation is required and installs the ST Link Server. Click on the [Continue] button.

Figure 10.ST Link Server welcome page (macOS®)

Reset perspective
  1. In this dialog, select the location for the installation of the ST Link Server.

  2. Click on [Install]. Log in to authorize the installation if prompted to do so.

  3. If a warning is displayed stating “This package is incompatible with this version of macOS and may fail to install”, click on [Install Anyway].

Figure 11.ST Link Server installer location dialog (macOS ®)

Reset perspective
  1. Click on [Close] and continue the installation of the STM32CubeIDE product.

Figure 12. ST Link Server installation finished (macOS ®))

Reset perspective

10.After successfully installing ST Link Server, drag the STM32CubeIDE icon to the Applications folder as indicated by the straight arrow.

Figure 13. STM32CubeIDE install page (macOS ®)

Reset perspective
  1. Wait for the installation to finish. When done, it is possible to launch STM32CubeIDEfrom the Launchpad by clicking on the IDE icon.

Figure 14. Installation progress bar (macOS ®)

Reset perspective

Rosetta® installation on M1-based computers

To install STM32CubeIDE on an M1-based computer running macOS®, the user is prompted to install Rosetta® for the STM32CubeIDE installation to proceed.

After accepting to install Rosetta®, the user credentials must be entered (see Figure 14), after which Rosetta® installation starts (see Figure 15).

Figure 15. Authentication window for Rosetta® installation

Reset perspective

Figure 16. Rosetta® installation proceeding

Reset perspective