IMPORTANT: There could be a conflict between the installation of AccessMod via the command line (Docker compose) and this one. The former will always work, but the access through the electron launcher could get jammed. Ideally, chose one of the two methods to install, run, and update AccessMod.

In Windows

Requirements

1. Install and start Docker desktop.
2. Download the installer file for AccessMod from GitHub: https://github.com/unige-geohealth/accessmod/releases/tag/5.8.0.
3. Additional settings:
   
   • From the Windows menu, type 'Settings' and select 'Apps'. Then in the first option 'Choose where to get apps', select 'Anywhere'.

Installation

1. Run the accessmod-5.8.0.Setup.exe file.
2. If there is a Firewall warning asking to allow AccessMod to connect to private and/or public networks, please allow both connections.
   
   
   
3. An additional message will ask you to select either the default Docker volume or another directory for AccessMod to store files. An different directory in your computer should be writable, but it should not be modified afterwards.
   
   
4. AccessMod will open.

In Apple

For Mac (Intel)

Requirements

1. Install and start Docker desktop.
2. Download the installer file for AccessMod from GitHub.

Installation

1. Add the installer to the applications, and from there right-click the app and select open. Direct activation is by default rejected by Apple.
2. A possible error message for invalid version can we waived with OK
   
3. An additional message will ask you to select either the default Docker volume or another directory for AccessMod to store files. An different directory in your computer should be writable, but it should not be modified afterwards.
4. AccessMod will open.

For Mac (M1)

Requirements

1. Install and start Docker desktop.
2. Download the installer file for AccessMod from GitHub: https://github.com/unige-geohealth/accessmod/releases/tag/5.8.0. Currently, this image only works for x86/intel Apple computers, but will allow you to download through the launcher a version (>5.7.20) that works with the M1 chips.

Installation

1. The installation steps 1 to 3 for Intel Mac also apply for M1. However, only the menu banner will open, and a possible error message could pop-up reporting that the App fail to load. Accept with OK.
   
   
2. From the menu banner, select Versions and from the sub-menu Remote all select any version higher than 5.7.20. If your current version is 5.8.0, you can install one lower or higher and then delete the 5.8.0 image from Docker and re-install it later through this method. 
   
   
3. AccessMod will open.

In Linux

To install AccessMod follow the steps in the command line tutorial.