{"sections":[{"heading":"Before starting","paragraphs":["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."]},{"heading":"Install and launch","steps":["Install the supported License Manager for the Mac, preserving licence files already used by other SUN Magnetics products.","Install the supplied JoSIM-Pro macOS package for the intended release and architecture. Review the package's own release/signing instructions.","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.","Review the licence check and correct any reported licence filename or service issue before choosing Retry.","Copy the complete example directory into a writable folder, open it in JoSIM-Pro and follow the JTL first-simulation guide."]},{"code":"josim-pro-cli -v\njosim-pro-gui","heading":"Command-line checks","paragraphs":["Run these checks in a new terminal after installation. A version response confirms executable discovery, not a valid extraction or simulation licence."]},{"heading":"Check the first run","paragraphs":["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."]},{"heading":"If the problem remains","paragraphs":["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."]}],"canonical_url":"https://www.sun-magnetics.com/knowledge-base/josim-install-macos","url":"/knowledge-base/josim-install-macos","known_issues":[],"search_record":{"execution":false,"relatedProducts":[],"version_tags":["JoSIM-Pro 2.9 target"],"text":"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. JoSIM-Pro 2.9.0 release target; source-documentation evidence How to install installation macos setup launch first run package licence license getting started application 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 Install the supported License Manager for the Mac, preserving licence files already used by other SUN Magnetics products. Install the supplied JoSIM-Pro macOS package for the intended release and architecture. Review the package's own release/signing instructions. 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. Review the licence check and correct any reported licence filename or service issue before choosing Retry. 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. josim-pro-cli -v\njosim-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. ","id":"josim-install-macos","keywords":"install installation macos setup launch first run package licence license getting started application","kind":"How to","title":"Install and launch JoSIM-Pro 2.9 on macOS","product":"JoSIM-Pro"},"version":"2.9.0 release target; source-documentation evidence","id":"josim-install-macos","related":["/knowledge-base/josim-first-jtl","/knowledge-base/josim-licensing-unavailable","/knowledge-base/josim-cli-output","/knowledge-base/josim-missing-include","/knowledge-base/shared-custom-licence-paths"],"downloads":[],"publication_status":"published","numerical_output":null,"provenance":{"execution_checks":[],"figure_evidence":[],"review_notes":["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."],"scope":"Recorded inputs/builds only. Complete walkthrough and final-package acceptance remain separate.","verification_requirements":{"gui_method":"product-native scenario or recorded operator walkthrough; screenshots required for GUI guidance","illustrations":"required","required":["technical-review","release-applicability","execution","gui-workflow","recovery","illustrations"],"status":"review-incomplete"},"sources":[{"id":"josim-pro:docs/manual_source/sections/getting_started.tex","section":"Choose the package; platform install and launch; Licensing and first-run behavior"}]},"title":"Install and launch JoSIM®-Pro 2.9 on macOS","type":"How to","markdown_url":"/_functions/kbResource?path=markdown%2Fjosim-install-macos.md","summary":"Use the supplied package for your Mac architecture, open JoSIM®-Pro.app or its GUI wrapper, and validate a copied first circuit.","product":"JoSIM-Pro"}