# JoSIM®-Pro does not launch or the terminal cannot find the CLI

Check installation features and use the provided Linux wrapper. GUI shortcuts and command-line PATH discovery are separate concerns.

## Compatibility

2.9.0 release target; review-build/source evidence

Published guidance with release-applicability limits. Confirm package applicability before following this guide.

## Windows

1. Repair or rerun the MSI if the expected Start Menu/Desktop shortcut is missing, selecting the desired shortcut features.
2. Open a new terminal after installation. Enable command-line PATH integration or use the installed bin directory when josim-pro-cli is not found.
3. Use a writable working copy of examples and confirm the exact installed version.

## Linux

Launch through /usr/local/bin/josim-pro-gui so the wrapper prepares the runtime library path. A missing or non-executable GUI binary message indicates a package/staging problem, not a netlist problem.

Use a dependency-resolving package-manager installation such as apt install, dnf install or yum install for the appropriate package. dpkg -i and rpm -i do not resolve dependencies automatically. Repair or reinstall the matching package if the wrapper cannot find its executable.

## Sources and verification details

Recorded inputs/builds only. Complete walkthrough and final-package acceptance remain separate.



- support:SUP-005: Generalised editorial finding; outcome qualification retained
- josim-pro:docs/manual_source/sections/troubleshooting.tex: The GUI launcher does not start
- owner:technical-review-20261102: JoSIM-Pro 2.9 chosen as the public starting path; release availability must be checked before publication

- Support history informed this draft. Current-source guidance has been checked; a fresh walkthrough on the intended distributed release and product-owner review remain pending.

## Related guides

- [JoSIM®-Pro reports a licensing problem or degraded mode](/knowledge-base/josim-licensing-unavailable)
- [Run the installed JTL example in JoSIM®-Pro](/knowledge-base/josim-first-jtl)