mathworks / mathworks/matlab-proxy
matlab-proxy hangs on "Starting" when JAVA_HOME points to invalid JDK path
@Shushant2502 is already working on this.
Since Aug 26, 2026.
- Dominant language
- Python
- Stars
- 88
- Forks
- 24
- PR merge metrics
- No merged PRs in 30d
Description
Summary
When JAVA_HOME points to a directory that is not valid, matlab-proxy-app starts and authenticates but the MATLAB status spins on "Starting" forever. It appears that MATLAB's Embedded Connector (a Java service) can't load a JVM, silently disables Java, and never comes up. No error is surfaced to the user and the startup just hangs.
root cause is a user error - JAVA_HOME env pointed to a nonexistant folder (in my case, the underlying java version was updated and I had a stale config) - but the failure mode was very hard to diagnose due to how it manifests with a hanging startup. A cleaner startup check / error message would be very helpful rather than behaving this way. Fixing the JAVA_HOME path resolves the issue and matlab startup succeeds
matlab-proxy: 0.34.0
MATLAB: R2025b Update 6
Python: 3.14.6
OS: RHEL 9 containerized workspace
Java: OpenJDK21 (not MATLAB's bundled JRE)
Browser(s) used
Chrome
Script output
not run
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.