Edited: 11.0.19

1

Installing HAP on Windows Server 2019 – HAP 10.5

Install and setup Windows Server 2019 as a basic server and add it to your domain as a member server making sure

the server has the correct server name configured. Make sure you have the appropriate Antivirus / antimalware protection and firewall rules configured. This guide does not show you how to configure these, it only shows you what

you need to do to get HAP working.

Open up Server Manager and Click Manage and Add Roles and Features

Next Before you Begin, Next Role-Based or feature based installation, Next Server Selection (make sure your server is selected).

SERVER ROLES: Select Web Server IIS, Click Next

FEATURES: Select ASP.NET 4.7 from .Net Framework 4.7, Click Next, and Next again.

WEB SERVER ROLE (IIS) > ROLE SERVICES: I selected the following:

ALL Common HTTP Features

ALL Security features

Application Development > .net Extensibility 4.7, ASP, ASP.NET 4.7, ISAPI Extensions, ISAPI Filters. Click Next to confirm and then Install.

Edited: 11.0.19

2

Open up IIS Management and right click on Application Pools > click Add Application Pool.

Give it a name of HAP and leave everything else as default.

Whilst in IIS, create a Self Signed Certificate until a new certitficate is either purchased or downloaded from

LetsEncrypt.

Jump into Server Certificates whilst the Server is highlighed.

Right click on the white space and choose Create Self-Signed Certiticate.

I gave mine a friendly name of HAP and chose to put it in Web Hosting.

The certificate will now be listed in the Server Certificates list.

Edited: 11.0.19

3

From the menu on the left, choose Default Web Site from under Sites. Now on the Right menu choose Bindings.

Now click Add, drop down the Type box and choose HTTPS. I left the Host Name blank and chose HAP as the

SSL Certificate. Click OK to set the certificate and then click Close. This is just to get HAP working in the first

instance.

Now open File Explorer on the server and browse to C:\inetpub\wwwroot and create a folder called HAP.

Download HAP+ Web Core v10 Full.zip from https://github.com/techienickb/hap/releases and extract the zip to

this new HAP folder that has been created.

Edited: 11.0.19

4

You will have a folder structure that looks like this:

You need to set the folder permissions on C:\inetpub\wwwroot\HAP now.

When setting where to look for iis apppool\hap please make sure the location is set to the local server. This will

lookup the user HAP from the IIS application pool that you created earlier. This user only needs READ & EXECUTE,

LIST FOLDER CONTENTS and READ access.

Now you need to browse to C:\inetpub\wwwroot\HAP\App_Data and set the user HAP to have MODIFY and WRITE

access.

Edited: 11.0.19

5

Now edit the Web.config file located at C:\inetpub\wwwroot\HAP in a text editor. Scroll down near to the bottom of

the file and remove the highlighted content below. Save the file in the HAP folder – you might need to save the config

file on the desktop and move it back to it’s original location after saving.

Now browse back up a level in file explorer to C:\inetpub\wwwroot and right click on HAP > Properties. Make sure

Read-only (Only applied to files in folder) is deselected. Click OK and agree to the messages it shows you.

Go back in to IIS manager and refresh the default Website from the Left menu. You will now see HAP listed.

Edited: 11.0.19

6

Right click on HAP > Convert to Application. A configuration Add Application window will be displayed. Change

the Application Pool to HAP from DefaultAppPool. Click OK to confirm settings.

Make sure HAP is selected from the Left menu and select Authentication.

Make sure only Anonymous Authentication and Forms Authentication are set as ENABLED. The rest should be

set as Disabled.

Edit Anonymous Authentication and set this to Application Pool Identity > Click OK.

You should now be able to browse to https://localhost/hap. You may get a This site is not secure, proceed to browse

to the webpage message. You might find it easier to browse to https://*servername*/hap.

Edited: 11.0.19

7

You’ll be presented with the following page:

Click on the Active Directory tab and enter your information into the boxes:

Edited: 11.0.19

8

Once the Base Settings goes to a green tick, click on the My Files tab to setup your folder mappings.

When you click Save, don’t forget to do the following:

Edited: 11.0.19

9

Installing a free Lets Encrypt Certificate (Correct at time of writing 11.07.19)

To install a free certificate on the HAP Server, download Certify SSL Manager from https://certifytheweb.com/. Once

downloaded install the application.

You need to register a new contact – enter an email address

Click on New Certificate and fill out the neccesary fields.

Click Save to save the settings.

Click Test to test a connection to Let’s Encrypt. You may need to edit some Port Forwards / Firewall rules on your

firewall / web filter if you are unable to get a test connection.

When successful, click Request Certificate.

Once you have the certificate you may need to go back into IIS, edit the bindings and tell HTTPS use the correct

certificate.