# Install and launch JoSIM®-Pro 2.9 on macOS

Use the supplied package for your Mac architecture, open JoSIM®-Pro.app or its GUI wrapper, and validate a copied first circuit.

## Compatibility

2.9.0 release target; source-documentation evidence

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

## Before starting

Use the intended JoSIM®-Pro 2.9 package and its matching manual. The owner selected 2.9 for publication; this guide does not claim the final release is already available.

Install the supported SUN Magnetics License Manager and keep the issued JoSIM®-Pro licence file. A valid licence is required to simulate; degraded startup permits only limited inspection and recovery.

Keep a writable working directory for copied circuits, included models and new output files.

Use the package built for the Mac's architecture when that package is supplied. Do not assume a universal binary or availability for another architecture.

## Install and launch

1. Install the supported License Manager for the Mac, preserving licence files already used by other SUN Magnetics products.
2. Install the supplied JoSIM®-Pro macOS package for the intended release and architecture. Review the package's own release/signing instructions.
3. Open /Applications/SUN Magnetics/JoSIM®-Pro.app or run josim-pro-gui. The maintained package also exposes josim-pro-cli and optimum-cli under /usr/local/bin.
4. Review the licence check and correct any reported licence filename or service issue before choosing Retry.
5. Copy the complete example directory into a writable folder, open it in JoSIM®-Pro and follow the JTL first-simulation guide.

## Command-line checks

Run these checks in a new terminal after installation. A version response confirms executable discovery, not a valid extraction or simulation licence.

```text
josim-pro-cli -v
josim-pro-gui
```

## Check the first run

The GUI opens and its licence check succeeds for the intended JoSIM®-Pro installation. The CLI reports the intended version.

Open a complete writable copy of JTL_Example.cir and follow the linked first-simulation guide. Accept only a completed current run with the expected traces and time coverage; retain its new data output.

A visible GUI, a version response or an importable API alone does not prove licensed simulation. This installation draft has not been executed end to end.

## If the problem remains

For a missing launcher, architecture error or macOS package rejection, record the actual package and message. Confirm that the correct architecture package was supplied; do not disable security controls or assume an Intel-only result qualifies Apple Silicon natively.

For a licence failure use the actual diagnostic to check the configured licence filename and licensing-service availability, then select Retry. Continue degraded does not enable simulations.

If simulation cannot find an included file, restore the complete copied example and correct its reference. For AND_Example.cir, keep base_cells.cir alongside it.

Retain the package, executable/version, operating-system/architecture and exact error for support; exclude licence keys, System ID contents and private circuit data from public reports.

## Sources and verification details

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



- josim-pro:docs/manual_source/sections/getting_started.tex: Choose the package; platform install and launch; Licensing and first-run behavior

- The bundle and wrapper paths are documented in maintained 2.9 source. Confirm them against the actual final package and complete the native macOS installation/licensed-first-run walkthrough before publication.

## Related guides

- [Run the installed JTL example in JoSIM®-Pro](/knowledge-base/josim-first-jtl)
- [JoSIM®-Pro reports a licensing problem or degraded mode](/knowledge-base/josim-licensing-unavailable)
- [Run JoSIM®-Pro from the command line and save numerical output](/knowledge-base/josim-cli-output)
- [A JoSIM®-Pro netlist cannot find an included file](/knowledge-base/josim-missing-include)
- [Set a custom daemon or licence-file path](/knowledge-base/shared-custom-licence-paths)