Installing Manually

For testing and pilot purposes you can install the HYPR Passwordless client application manually for each user. However, for deploying to larger segments of your workforce population you'll want to integrate with a configuration management solution such as Microsoft Endpoint Configuration Manager (formerly SCCM) or Jamf on macOS.

Platform-Specific Installation

Choose your platform for detailed installation instructions:

• Windows Installation and Configuration - MSI installation, Registry settings, and Windows-specific configuration
• macOS Installation and Configuration - PKG installation, plist configuration, and macOS-specific settings

Common Installation Parameters

Both Windows and macOS installations share common configuration parameters that can be set via platform-specific methods (e.g., a hypr.json file).

Configuration File

For both Windows and macOS, the HYPR installer reads its configuration parameters from the hypr.json file located in the same directory as the installer. For Windows workstations, you can also pass the parameters directly on the command line.

All Right

If your downloaded install package already includes a hypr.json file, be cautious about changing any of the preconfigured values. This file is how HYPR provides the appropriate parameters required for your particular environment.

The hypr.json file is a simple collection of name-value pairs, each defining a single install parameter. For example:

{
  "version": "1.0",
  "rpUrl": "https://highlandsbank.gethypr.com/rp",
  "appId": "HYPRDefaultWorkstationApplication",
  "pinningHash": "Sp4nxBnLypng05MKvujez/+y8raO7p9wc9ctaPNGI5U=,++MBgDH5WGvL9Bcn5Be30cRcL0f5O+NyoXuWtQdX1aI=",
  "installToken": "0f03f635-4d9a-46ff-b537-cd97ad77cb6e",
  "certTemplate": "hyprwin",
  "securityKeyCertTemplate": "",
  "supportEmail": "support@hb.com",
  "fullUI": "1"
}

Key Parameters

Both Windows and macOS installations share several core parameters, some of which are required for all installations:

Parameter	Description	Required
rpUrl	The URL of your HYPR instance (must end in /rp)	Yes
appId	The ID of the HYPR Control Center application (HYPRDefaultWorkstationApplication)	Yes
pinningHash	SSL/TLS certificate hash for public key pinning	Yes
installToken	Token for encrypted communication with HYPR Server	Yes
certTemplate	Active Directory certificate template name	No
supportEmail	Email address for support requests	No

For other, platform-specific parameters and further details, see the individual installation pages:

• Windows Installation and Configuration - Complete Windows parameter reference
• macOS Installation and Configuration - Complete macOS parameter reference