Skip to content

Instantly share code, notes, and snippets.

@Lanchon

Lanchon/stm32cubemx-linux.md

Last active September 18, 2025 06:42
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Lanchon/2156953d18f7534a926b to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Lanchon/2156953d18f7534a926b to your computer and use it in GitHub Desktop.
Download ZIP
Installing STM32CubeMX on Linux
Raw
stm32cubemx-linux.md

Installing STM32CubeMX on Linux

The STM32CubeMX tool is written in portable java, but unfortunately it is distributed as a Windows executable embedded in a Windows installer.

To install it on Linux:

  1. sudo java -jar SetupSTM32CubeMX-4.11.0.exe
  2. install the tool somewhere in your home, eg: /home/you/stm32/cubemx
  3. sudo chown -R you:you /home/you/stm32/cubemx

To run it:

  • java -jar /home/you/stm32/cubemx/STM32CubeMX.exe
  • or mark that file as executable, rename it to STM32CubeMX.jar, and double click it
@K1ngjulien
Copy link

K1ngjulien commented Mar 25, 2019 •
edited
Loading

@VictorTagayun
Save the following code in ~/.local/share/applications/stm32cubemx.desktop:

[Desktop Entry]
Name=STM32CubeMX
GenericName=STM32CubeMX
Comment=Graphical tool for configuration of STM32 Microcontrollers
Exec=/usr/local/STMicroelectronics/STM32Cube/STM32CubeMX/STM32CubeMX
Terminal=false
X-MultipleArgs=false
Type=Application
Icon=/home/<USERNAME>/.local/share/applications/icons/stm32cubemx.png
StartupWMClass=STM32CubeMX
StartupNotify=true

And don't forget the icon in ~/.local/share/applications/icons/stm32cubemx.png or change the paths in the .desktop-file accordingly.
stm32cubemx

Hope this helps :)

@symdeb
Copy link

symdeb commented Sep 14, 2019

Above solutions don't work for CubeProg (Ubuntu 19.04 Linux x64)

sudo ./SetupSTM32CubeProgrammer-2.1.0.linux
Error: Unable to access jarfile SetupSTM32CubeProgrammer-2.1.0.exe

Sudo java -jar SetupSTM32CubeProgrammer-2.1.0.linux
Error: Invalid or corrupt jarfile SetupSTM32CubeProgrammer-2.1.0.linux

@simonsunnyboy
Copy link

simonsunnyboy commented Dec 3, 2019

Above solutions don't work for CubeProg (Ubuntu 19.04 Linux x64)

sudo ./SetupSTM32CubeProgrammer-2.1.0.linux
Error: Unable to access jarfile SetupSTM32CubeProgrammer-2.1.0.exe

Sudo java -jar SetupSTM32CubeProgrammer-2.1.0.linux
Error: Invalid or corrupt jarfile SetupSTM32CubeProgrammer-2.1.0.linux

Use the windows .exe instead. The .linux file is only for old 32bit architectures and does not run anymore on AMD64 systems (if i understood correctly)

It worked fine for me on Ubuntu 18.04 here. I renamed the .exe to .jar to make sure.

@Lanchon
Copy link
Author

Lanchon commented Dec 3, 2019

@VictorTagayun,

this solution provided to your is perfect: https://gist.github.com/Lanchon/2156953d18f7534a926b#gistcomment-2871284

however, there are quite a few GUI menu editors you can easily install from the ubuntu repos, such as MenuLibre. try them!

@vincentl-dev
Copy link

vincentl-dev commented Apr 17, 2020

Hello and thanks to all. I could follow simonsunnyboy & kingjulien advices and install on Ubuntu 19.10 latest version of CubeMX (5.6.1)
Everythings works ok (Design & code generation) , However update from the CubeMX make the tool freeze, I have to reboot the machine.
Since I run Linux from VirtualOrg, it could be virtual machine settings not cubeMX tool. Can anybody with a real linux machine has update working fine ? (Please note all my internet browser, mails are working fine in my Ubuntu virtual machine).
Thanks a lot !

@simonsunnyboy
Copy link

simonsunnyboy commented Apr 17, 2020 •
edited
Loading

Hello and thanks to all. I could follow simonsunnyboy & kingjulien advices and install on Ubuntu 19.10 latest version of CubeMX (5.6.1)
Everythings works ok (Design & code generation) , However update from the CubeMX make the tool freeze, I have to reboot the machine.
Since I run Linux from VirtualOrg, it could be virtual machine settings not cubeMX tool. Can anybody with a real linux machine has update working fine ? (Please note all my internet browser, mails are working fine in my Ubuntu virtual machine).
Thanks a lot !

I just tried the update here on a real linux machine. It installed an update of the Cube to V5.6.1 without issues.
Priviliges can be of concern.

I made sure to install the CubeMx here with my user priviliges on a folder with my user acces rights.
A popup with adminstrator restart came up but I safely ignored that one. No need no login or sudo, I just restarted the CubeMX GUI as my regular user and it worked for me.

Addendum I also did not a sudo install of the original package IIRC.

@vincentl-dev
Copy link

vincentl-dev commented Apr 17, 2020

thanks simonsunnyboy. Since you shared STM32CubeMX's update were working fine on a "real" linux, I 've tried a bit to play around with VirtualBox's setting. Then i've seen in readme of the tool that it was a java 32 bits software. So i've installed 32 bits version of JRE
sudo apt-get install default-jre:i386
and "Voila !" STM32CubeMX update were suddently working.
The STM32CubeMx however trigs me a message telling it is not happy to have 32 bits JRE installed in 64 bits Linux.
sudo apt-get install default-jre
allow me to get rig of it...
So in the end I guess STM32CubeMX is finding what it need for the java...I must have some bits of jre 32 bits and 64 bits in my system...
I am definitly not llinux expert so sorry guys cannot really explain why it is working but only what I did to have it work !
good night !

@photon-delight
Copy link

photon-delight commented Jun 2, 2020 •
edited
Loading

Above solutions don't work for CubeProg (Ubuntu 19.04 Linux x64)

sudo ./SetupSTM32CubeProgrammer-2.1.0.linux
Error: Unable to access jarfile SetupSTM32CubeProgrammer-2.1.0.exe

Sudo java -jar SetupSTM32CubeProgrammer-2.1.0.linux
Error: Invalid or corrupt jarfile SetupSTM32CubeProgrammer-2.1.0.linux

One needs to extract both the .linux and .exe files. My mistake was that I assumed that only the .linux was necessary to extract. Once both of these files have been extracted, ./SetupSTM32CubeProgrammer-2.4.0.linux works as it should

@mianqi2016
Copy link

mianqi2016 commented Feb 27, 2021

I have downloaded STM32CubeMX for Linux, and extracted it on Ubuntu 20.04, and double-click the setup file, no error prompted, but I couldn't launch it, how to?

@emha69
Copy link

emha69 commented Apr 29, 2021

Current version (6.2.0) installs normally on Ubuntu, however you need to install JDK 11 first:

sudo apt install openjdk-11-jre

Then start installer with sudo and at the end change the ownership of all files in the selected folder

chown -R user.user STM32CubeMX

Note, that you will need to start CubeMX as root in order to finish the update to version 6.2.1 and repeat chown -R ... afterwards.

@photon-delight
Copy link

photon-delight commented Apr 30, 2021 •
edited
Loading

One does not need to install the JDK anymore - it seems to be included in the latest archive from ST. I just installed both STM32CubeIDE and CubeProgrammer on a fresh Ubuntu 20.04 without installing any Java. ST has also updated their software install instructions, which work fine for Ubuntu 20.04

@willcmc
Copy link

willcmc commented May 18, 2021

As of version 6.2.1, the provided Linux installation package on ST's website is designed for and tested on 64-bit systems, and (from what I gather) works only on a 64-bit system (sorta redundant to state, since ubuntu 20.04 only comes in 64-bit). And yes, no need for JDK, it is bundled with the package.

@willcmc
Copy link

willcmc commented May 18, 2021

I have downloaded STM32CubeMX for Linux, and extracted it on Ubuntu 20.04, and double-click the setup file, no error prompted, but I couldn't launch it, how to?

Have a look at the Readme.html, there are comprehensive instructions for each OS.

@emha69
Copy link

emha69 commented May 18, 2021 •
edited
Loading

Current version (6.2.0) installs normally on Ubuntu, however you need to install JDK 11 first:

sudo apt install openjdk-11-jre

Installation of JDK was required on Ubuntu 18.04.3 64-bit. Forgot to mention the version.

I have downloaded STM32CubeMX for Linux, and extracted it on Ubuntu 20.04, and double-click the setup file, no error prompted, but I couldn't launch it, how to?

Check your user's permissions of the folder and sub-folders, where the IDE was installed. Start IDE from the terminal as normal user, you will see in the output where is the problem (or paste it here).

@artemfromkyiv
Copy link

artemfromkyiv commented May 17, 2022

When I tried to setup SetupSTM32CubeProgrammer-2.10.0.linux I got error:
Exec error: Permission denied
just check permission for files in ./jre/bin folder. They must be executable.
Zip archive clear executable bit for all files.

@gpmontt
Copy link

gpmontt commented Sep 5, 2024

@VictorTagayun Save the following code in ~/.local/share/applications/stm32cubemx.desktop:

[Desktop Entry]
Name=STM32CubeMX
GenericName=STM32CubeMX
Comment=Graphical tool for configuration of STM32 Microcontrollers
Exec=/usr/local/STMicroelectronics/STM32Cube/STM32CubeMX/STM32CubeMX
Terminal=false
X-MultipleArgs=false
Type=Application
Icon=/home/<USERNAME>/.local/share/applications/icons/stm32cubemx.png
StartupWMClass=STM32CubeMX
StartupNotify=true

And don't forget the icon in ~/.local/share/applications/icons/stm32cubemx.png or change the paths in the .desktop-file accordingly. stm32cubemx

Hope this helps :)

It works like a charm 👍 .
it amazes me that the stm32cubemx installer does not perform that option.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment