admin:msupplyclient-for-a-mac

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
admin:msupplyclient-for-a-mac [2026/07/07 09:51] – [Code Signing (may be required)] Ujwal Khatryadmin:msupplyclient-for-a-mac [2026/07/07 09:53] (current) – Ujwal Khatry
Line 1: Line 1:
 {{indexmenu_n>200}} {{indexmenu_n>200}}
- 
- 
-<WRAP center round alert 60%> 
- 
-This is Work in progress : The doc hasn't been finished yet.  
- 
-</WRAP> 
  
 ====== 25.23. mSupply Client for a MAC ====== ====== 25.23. mSupply Client for a MAC ======
Line 51: Line 44:
   * The app can be **locally code-signed on a Mac** before distributing it to the end user (this has been done successfully by support staff prior to sending the app to a client). However it is possible for users to do it on their MAC via the terminal by running the code : ''codesign --force --deep --sign - /path/to/mSupply\ Client.app''   * The app can be **locally code-signed on a Mac** before distributing it to the end user (this has been done successfully by support staff prior to sending the app to a client). However it is possible for users to do it on their MAC via the terminal by running the code : ''codesign --force --deep --sign - /path/to/mSupply\ Client.app''
  
-===== Version Notes ===== 
- 
-  * For sites needing an update alongside a Mac setup, running the relevant version upgrader (e.g. V9.01.03) on the server may be sufficient — check the current recommended version before advising a client. 
- 
-===== Troubleshooting Checklist ===== 
- 
-  - Is the Mac on the same network as the server? If not, that's the most common blocker. 
-  - Try connecting using the server's **IP address** directly instead of a hostname in the custom setting. 
-  - Does macOS refuse to open the app (Gatekeeper warning)? → Locally code-sign the Client.app. 
-  - Confirm the server itself is reachable (ping / port check) before assuming it's a client-side issue. 
- 
-===== Known Limitations / Open Work ===== 
- 
-  * There's an open GitHub issue to build a server executable that is more Mac-client-friendly: [[https://github.com/msupply-foundation/msupply/issues/18363]]. Check this issue for current progress before troubleshooting from scratch. 
-  * This guide should be reviewed and expanded by the support team (see internal ticket #GT-9612-AP) — particularly the code-signing steps, which haven't been fully written up yet. 
- 
-===== References ===== 
  
-  * Support ticket: #GT-9612-AP — Setup for Mac in Kiribati 
-  * GitHub issue: https://github.com/msupply-foundation/msupply/issues/18363 
-  * Client: Peter Laing, Beyond Essential Systems (Kiribati) 
  
----- 
-//Last updated: drafted from ticket #GT-9612-AP. Please edit/expand with exact code-signing commands and any additional edge cases encountered.// 
  
  
  • Last modified: 2026/07/07 09:51
  • by Ujwal Khatry