Humly Control Panel Installation - Windows

Note: This step is only for on-prem installations. If you have a cloud account, please skip this step.

Windows On-Premise Installation Prerequisites

• Windows Server 2019 64-bit or later.
  Note: Windows Server 2016 is only supported on HCP 1.29 and below. HCP 1.30 and onward cannot be installed on Windows Server 2016.
• Minimum of 4 cores, 8 GB of RAM, and 40 GB storage.
• A static IP address for the Humly Control Panel.
• Accessible ports for HTTP and HTTPS protocols. Default ports are TCP 3000 and TCP 3002. Port TCP 3000 is only used within localhost as it is forwarded to port 3002.
• Accessible booking system backend (e.g., M365, Exchange, Google Workspace, or Nexudus) over HTTPS port TCP/443.
• Access to NTP server over port UDP 123.
• Administrator permission on the machine.

Installation Files

There are two different installer types available for Windows-based Humly Control Panel installations.

Download the installers from here.

Humly Control Panel Online Installer

Smaller file size, but requires internet access during installation as some packages are downloaded from the internet.

Humly Control Panel Offline Installer

Larger file size, but does not require internet access during installation. Use this option if the machine is running in an isolated or restricted network.

Installation Steps

This guide uses HCP v1.15.0.19 on a Windows Server 2022 64-bit machine.

1. It is highly recommended to update your Windows using Windows Update to ensure that the proper .NET and build packages are included in the OS.
2. Download the installation file for Humly Control Panel and copy it to the machine where you want it installed.
3. Right-click the installation file and select Run as administrator.
   
4. Agree to the terms of service and click Install.
   
5. Click Next after the Setup Progress finishes.
   
6. Choose the file path where Humly Control Panel should be installed and click Next.
   
7. Create credentials for the MongoDB database. MongoDB is stored internally on your machine and acts as the database for meetings, users, and Humly Control Panel settings. Click Next when ready.
   
8. Click Install and let the installation run. Depending on your OS, a restart may be required after installing Visual C++ "19" Runtime Libraries (x64). If so, restart your OS and run the installation file again.
   
9. When the process is complete, click Finish.
   
10. You can now access the Humly Control Panel in a web browser using http://localhost:3000 or from another machine using http://<IP or FQDN>:3000. Port 3000 forwards to port 3002, so you will be redirected to https://localhost:3002.
11. Depending on your browser, you may see a certificate warning because the current certificate is self-signed. You can replace it with an SSL certificate either now or later during the HCP wizard.
     
12. The server is now ready to be connected to a booking system. Proceed to Step 3: Connect HCP to Booking System.

Troubleshooting

Use the sections below if you run into issues during or after the Windows installation.

Installer does not launch or immediately closes

Possible causes:

• The installer was not run as administrator.
• Windows is missing required .NET or Visual C++ Runtime components.
• The downloaded installer file is corrupted.

Steps to resolve:

1. Right-click the installer and select Run as administrator. Do not double-click the file.
2. Run Windows Update to install any pending updates, particularly .NET Framework packages, then try the installer again.
3. Re-download the installer from the official download page and verify the file is not corrupted before running it.

Installation fails or gets stuck mid-process

Possible causes:

• Insufficient disk space (less than 40 GB available).
• Another installation or Windows Update is running in the background.
• A Visual C++ Runtime restart is required but was not performed.
• Antivirus or security software is blocking the installation.

Steps to resolve:

1. Verify that the target drive has at least 40 GB of free space before starting the installation.
2. Ensure no other installations or Windows Updates are running at the same time.
3. If prompted to restart after installing Visual C++ "19" Runtime Libraries (x64), restart the machine and re-run the installer – this is expected behaviour.
4. Temporarily disable antivirus or endpoint protection software during installation, then re-enable it afterwards.
5. Check the Windows Event Viewer (Start > Event Viewer > Windows Logs > Application) for error entries related to the installation and share these with Humly Support if needed.

Humly Control Panel is not accessible after installation

Possible causes:

• The HCP service did not start after installation.
• A firewall is blocking ports TCP 3000 or TCP 3002.
• The wrong IP address or hostname is being used to access the panel.

Steps to resolve:

1. Open Windows Services (services.msc) and confirm that the Humly Control Panel service is running. If it is stopped, right-click it and select Start.
2. Check the Windows Firewall and any network firewalls to ensure that inbound traffic is allowed on ports TCP 3000 and TCP 3002.
3. Try accessing the panel locally first using http://localhost:3000. If that works, the issue is likely network-related when accessing from another machine.
4. Verify that you are using the correct static IP address or FQDN of the server.

Browser shows a certificate warning or "Your connection is not private"

Possible causes:

• The default self-signed certificate is in use and has not yet been replaced with a trusted SSL certificate.

Steps to resolve:

1. This is expected behaviour with a fresh installation. You can bypass the warning during initial setup by clicking Advanced > Proceed in your browser.
2. To resolve the warning permanently, replace the self-signed certificate with a valid SSL certificate. This can be done during the HCP setup wizard or afterwards in the server settings.
3. Contact your IT administrator or reseller if you need guidance on obtaining and installing an SSL certificate.

MongoDB fails to start or credentials are rejected

Possible causes:

• Incorrect MongoDB credentials were entered during installation.
• MongoDB port 27017 is blocked or already in use by another process.
• The MongoDB service failed to start after installation.

Steps to resolve:

1. Open Windows Services and verify that the MongoDB service is running. Start it manually if needed.
2. Check if port 27017 is already in use by running netstat -ano | findstr 27017 in Command Prompt. If another process is using the port, it must be stopped or reconfigured.
3. If the credentials entered during installation were incorrect, uninstall Humly Control Panel and MongoDB, then re-run the installer and set new credentials.

Installation succeeds but HCP wizard does not start

Possible causes:

• The browser is caching a previous state or the URL is incorrect.
• The HCP service has not fully started yet.

Steps to resolve:

1. Wait 1–2 minutes after installation completes for the services to fully start, then try again.
2. Clear your browser cache or try opening the URL in a private/incognito window.
3. Confirm you are using the correct URL: http://localhost:3000 (local) or http://<IP or FQDN>:3000 (remote).
4. Restart the Humly Control Panel service in Windows Services and try again.

Still need help?

If none of the steps above resolve your issue, please create a support ticket and include the following information:

• The Windows Server version (e.g., Windows Server 2022)
• The HCP installer version used (online or offline)
• A description of where in the process the issue occurred
• Any error messages or screenshots
• Relevant entries from the Windows Event Viewer (Application log)