===== Installation =====

Last release: 06.06.2023 (Version 1.0.100)

PLEASE READ THE [[ig:gfx:geometrymanager_history|RELEASE NOTES]] BEFORE RUNNING THE NEW VERSION!

PLEASE READ THE FOLLOWING INSTRUCTIONS WHEN INSTALLING THE GEOMETRY MANAGER FOR THE FIRST TIME!

After installation, please use the "GeometryManager" entry in the Windows startbar or MacOS app menu.

**[[https://nextcloud.intelligentgraphics.biz/index.php/s/sxSD9qbii2qRZm3|Download for Windows 10 or higher, Version 1.0 LTS, 1.0.100, 06/06/23]]**

**[[https://nextcloud.intelligentgraphics.biz/index.php/s/CzCLj2xTSdjw7QN|Direct download (MacOS), Version 1.2 LTS, 1.0.100, 06/06/23]]**

**MacOS (Step by Step)**

  * Download the package file from the link above.
  * Do not open the pkg file directly, please open the Finder, goto Downloads and Ctrl+Click the pkg file and choose open in the popup menu.
  * In the dialog next, click open and start the installation.
  * If the installation finished, there must be an Entry "IG.GFX.GeometryManager" in the launchpad.

**IMPORTANT**

The IG GeometryManager app is not available from the Apple Store and may be blocked by macOS.
The following link contains all relevant information for this case.

[[https://macpaw.com/how-to/allow-apps-anywhere|Allow apps from anywhere]]

**Windows (Step by Step)**

  * Download the msix package file from the link above.
  * Execute the msix package.
  * The package installer loads and install all required dependencies packages.
  * If the installation finished, there must be an Entry "IG.GFX.GeometryManager" in the Windows start menu.

IMPORTANT

To run the IG GeometryManager app under Windows, please turn on the developer mode if required.

{{ :ig:gfx:screenshot_2023-06-06_153815.jpg?400 |}}

**BEFORE** you can install the GM with the MSIX installation program , an certificate issued by IG must be installed once.

**How can I tell if I have not installed the certificate yet?**

If you run the installer (MSIX), the installation button is grayed out and not works.

{{ :ig:gfx:screen1_installer.png?400 |}}

Please follow the next chapter to install the certificate on to your pc.

**Install the IG certificate**

Please follow the steps exactly as described, otherwise the installation cannot be performed correctly.

There is an documentation on the Microsoft pages ([[https://docs.microsoft.com/en-us/dotnet/maui/windows/deployment/overview#installing-the-app]]), you can use this guide, but note, the file is named **IG.GFX.GeometryManager?4.msix** in our case. The page is also available in german: [[https://docs.microsoft.com/de-de/dotnet/maui/windows/deployment/overview#installing-the-app]].

* Open your installation folder and select the file **IG.GFX.GeometryManager?.msix**.

* Open the file details with right mouse click and then "Properties" or Alt+Return.
{{ :ig:gfx:screen2-1_properties.png?400 |}}

* Select the "Digital signatures" tab and select the certificate in this dialog.

* Use the "Details" button to open an extra dialog window.
{{ :ig:gfx:screen2-2_cert_details.png?400 |}}

* "Details" click on "View certificate"

* In the certificate window, use the "Install Certificate" button to add this certificate to your pc.

* Use the options **Install on locale computer** and **Place all certificates in the following store**.

* Select store "Trusted people"
{{ :ig:gfx:screen2-3_install_local.png?400 |}}
{{ :ig:gfx:screen2-4_install_store.png?400 |}}

* Close the dialog after all and restart the installation with the MSIX installer.

{{ :ig:gfx:screen3_ready_to_install.png?400 |}}

**What should I do if the installation fails?**

The first thing to check is that these instructions have been followed step by step and that all the necessary components have been installed and all the setup steps have been carried out successfully.

Furthermore you can open an ticket in the IG Support System in the in the associated project.