Installation Troubleshooting

Windows SmartScreen Warning

Symptom: Windows shows "Windows protected your PC" or "Unknown publisher" warning.

Solution: Click "More info" and then "Run anyway". This warning appears because the installer is not yet code-signed and has not built SmartScreen reputation. Installing with winget (winget install RbDevOps.HMPraxis) simplifies setup and keeps the app updated, but it installs the same unsigned package, so the same warning can still appear.

Installation Fails with "Access Denied"

Symptom: Installer shows permission error or "Access Denied" message.

Solution: Right-click the installer file (.msi) and select "Run as Administrator". Windows requires admin rights to install applications in Program Files.

Antivirus or Windows Defender Blocks Installation

Symptom: Antivirus software quarantines or deletes the installer.

Solution:

1. Temporarily disable your antivirus during installation
2. Or add an exception for the HM Praxis installer and installation directory
3. Download the installer again if it was quarantined
4. Re-enable your antivirus after installation completes

Installer Won't Launch or Crashes Immediately

Symptom: Double-clicking the installer does nothing or shows an error.

Solution:

1. The download may be corrupted. Delete the file and download it again.
2. Make sure you have the correct version (64-bit Windows 10/11)
3. Install the Microsoft Edge WebView2 Runtime if it is missing (it ships with Windows 11 and recent Windows 10 updates)
4. Make sure Windows is up to date via Windows Update

Not Enough Disk Space

Symptom: Installation fails with disk space error.

Solution: Free up at least 500 MB on your C: drive. Delete temporary files (run Disk Cleanup) or uninstall unused applications.

"HM Praxis is damaged and can't be opened"

Symptom: macOS Gatekeeper blocks the app from opening.

Solution:

1. Right-click (or Control+click) the application icon
2. Select "Open" from the menu
3. Click "Open" in the confirmation dialog
4. You only need to do this once - macOS will remember your choice

App from Unidentified Developer

Symptom: macOS won't open the app because it's not from the App Store.

Solution:

1. Go to System Settings → Privacy & Security
2. Scroll down to the Security section
3. Click "Open Anyway" next to the HM Praxis warning
4. Alternatively, use the right-click method described above

Wrong Architecture (Intel vs Apple Silicon)

Symptom: App crashes immediately on launch.

Solution: Make sure you downloaded the correct version:

• Apple Silicon (M1/M2/M3): Download the aarch64 version
• Intel Macs: Download the x64 version

To check your Mac's processor, click the Apple menu → About This Mac.

Can't Copy to Applications Folder

Symptom: Drag-and-drop to Applications fails or shows an error.

Solution:

1. Make sure you have admin privileges on your Mac
2. Check disk space - you need at least 500 MB free
3. Open Finder, press ⌘+Shift+A to go to Applications
4. Manually drag the app from the DMG to this folder
5. Enter your admin password when prompted

DMG File Won't Mount

Symptom: Double-clicking the .dmg file does nothing or shows an error.

Solution:

1. The download may be corrupted. Delete and re-download the file.
2. Check the file size - it should be around 100-200 MB
3. Try opening from Terminal: hdiutil attach ~/Downloads/AppName*.dmg

Permissions Errors After Installation

Symptom: App launches but can't access files or create databases.

Solution:

1. Go to System Settings → Privacy & Security
2. Click "Files and Folders" in the left sidebar
3. Find the application and enable access to Documents and Desktop
4. Restart the app