Running HiveMQ Edge as a service on Windows OS

To run HiveMQ Edge as a Windows service, we provided an alternative Windows service installation by using the NSSM tool.

We recommend installing HiveMQ Edge in the C:\hivemq directory. The following steps assume this directory is used. If you have extracted HiveMQ Edge to a different directory on your Windows OS, please update the $installationFolder variable in the PowerShell script accordingly.

# HiveMQ Edge installation folder
$installationFolder = "C:\hivemq"

Instructions for installing Windows service

1. First, download a PowerShell script that will automate all required steps in the GitHub repository below.

Download Install-HiveMQEdge-WindowsService.ps1

2. Open Windows PowerShell as administrator.

3. Temporarily sets the current PowerShell session execution policy to Bypass.

Set-ExecutionPolicy Bypass -Scope Process -Force

4. Navigate to the folder where you downloaded the PowerShell script and execute the InstallEdgeService.ps1 script to install the HiveMQ Edge service and observe the execution output in the terminal.

.\InstallEdgeService.ps1

If the HiveMQ Edge Windows service is installed successfully, you will see the output like the screenshot below.

5. At this point, you may confirm that HiveMQ Edge is up and running. First, double-check if the service is installed and with the status “running”.

6. The next step is to verify if you can access the HiveMQ Edge administrative console in your browser at http://localhost:8080. The default username is admin and the default password is hivemq.

7. Restart your machine. Upon reboot, verify that HiveMQ Edge starts automatically.

Instructions for uninstalling Windows service

To remove the HiveMQ Edge service, simply execute the following commands in either a Command Prompt or a PowerShell window.

C:\hivemq\windows-service\nssm.exe stop HiveMQEdgeService

C:\hivemq\windows-service\nssm.exe remove HiveMQEdgeService confirm