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 a hypr.json file or platform-specific methods.
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, you can also pass the parameters directly on the command line.
If your downloaded install package already includes a hypr.json file, be cautious about changing any of the preconfigured values. This is how HYPR provides the necessary custom parameters for your installation.
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 that must be configured:
| 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 complete parameter lists and platform-specific details, see the individual installation pages:
- Windows Installation and Configuration - Complete Windows parameter reference
- macOS Installation and Configuration - Complete macOS parameter reference