Matlab opens gui even with -nosplash and -nodesktop on linux

Hi,
I am running latest matlab in WSL2 (on windows 10) and every time I try to run without GUI, i.e. using any combination of -nodisplay, -nodesktop, -nosplash, -nojvm, or even in case -batch matlab tries to open GUI. Because I run wsl, I cannot simply use that. How do I run without needing graphics?

Answers (1)

Here are some steps you can try to run MATLAB in true headless mode:
1. Use the -batch Option
The -batch flag is the recommended way to run MATLAB scripts non-interactively and without any GUI:
matlab -batch "your_script"
This should execute your script and exit without opening any GUI windows.
2. Unset the DISPLAY Environment Variable
Before launching MATLAB, make sure the DISPLAY environment variable is unset. This prevents MATLAB from trying to connect to an X server:
unset DISPLAY
matlab -nodesktop -nosplash -r "your_script;exit"
Hope this helps!

2 Comments

Thanks, the latter works
Hi Leo,
You can do -batch to run scripts and exit just like Anjaneyulu mentioned.
If you want to run the terminal mode, please try the flag -nodisplay instead of -nodesktop. This should open MATLAB in the terminal.

Sign in to comment.

Categories

Products

Release

R2025b

Asked:

Leo
on 8 Oct 2025

Edited:

Ivy
on 18 Dec 2025

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!