HiveMQ Edge General Installation Information

HiveMQ Edge is available for download in a ZIP archive that includes executables files, init scripts, and sample configurations.

OpenJDK JRE 11 or newer is required for production environments. To check the which Java version is currently installed on your system, enter java -version on your command line. For more information, see HiveMQ Edge System Requirements.

The HiveMQ Edge download contains the following directories:

Folder name Description

Folder name	Description
`bin`	HiveMQ Edge startup scripts and binary files.
`conf`	HiveMQ Edge configuration files.
`data`	Persistent client data and cluster data.
`license`	One of more HiveMQ license files.
`log`	All log files can be found here.
`extensions`	All extensions to the HiveMQ Edge installation.
`third-party-licenses`	License information for third-party libraries.

bin

HiveMQ Edge startup scripts and binary files.

conf

HiveMQ Edge configuration files.

data

Persistent client data and cluster data.

license

One of more HiveMQ license files.

log

All log files can be found here.

extensions

All extensions to the HiveMQ Edge installation.

third-party-licenses

License information for third-party libraries.

HiveMQ Edge provides several example configuration files in the conf/examples directory. Additionally, The HiveMQ University Introduction to HiveMQ Edge provides useful information and step-by-step instructions for installation with Docker on Windows 11.

HiveMQ Edge Installation on Unix-based systems (Linux, BSD, MacOS, Unix)

The default installation directory for HiveMQ Edge is /opt/hivemq. The default user to run HiveMQ Edge is named hivemq.

If you need to install HiveMQ Edge to a custom directory or run it under a custom user, you must update the $HIVEMQ_DIRECTORY and/or the HIVEMQ_USER in the $HIVEMQ_DIRECTORY/bin/start.sh script.

Download HiveMQ Edge from the official HiveMQ website.

Some of the following commands need root privileges. Log in as root user or use sudo to execute the commands.
Move the downloaded ZIP file to the directory where you want to install HiveMQ Edge. In this example we use /opt.
Extract the files from the ZIP archive:
```
unzip hivemq-edge-latest.zip
```

Create a HiveMQ symbolic link (symlink):

ln -s /opt/hivemq-edge-<version> /opt/hivemq

Create a HiveMQ user:
```
useradd -d /opt/hivemq hivemq
```

Make scripts executable and change owner to hivemq user:

chown -R hivemq:hivemq /opt/hivemq-edge-<version>
chown -R hivemq:hivemq /opt/hivemq
cd /opt/hivemq
chmod +x ./bin/run.sh

Adjust the configuration properties to your needs.
For detailed information and configuration examples, see HiveMQ Edge Configuration.

Install the init script (optional):

For Debian-based Linux distributions such as Debian, Ubuntu, or Raspbian that use init.d scripts:

cp /opt/hivemq/bin/init-script/hivemq-debian /etc/init.d/hivemq
chmod +x /etc/init.d/hivemq

For Linux systems that use a systemd service:

cp /opt/hivemq/bin/init-script/hivemq.service /etc/systemd/system/hivemq.service

For all other Linux systems:

cp /opt/hivemq/bin/init-script/hivemq /etc/init.d/hivemq
chmod +x /etc/init.d/hivemq

Modify /etc/init.d/hivemq (optional)

Set the HIVEMQ_HOME and the HIVEMQ_USER variables to the correct values for your system.

The default values are as follows:

HIVEMQ_HOME=/opt/hivemq

HIVEMQ_USER=hivemq

If you installed HiveMQ on a directory other than /opt/hivemq, point the HIVEMQ_HOME in your init script to the correct directory. Otherwise, the daemon cannot start correctly.
Start HiveMQ on boot (optional)

For Debian-based Linux distributions such as Debian, Ubuntu, or Raspbian:
```
update-rc.d hivemq defaults
```
For Debian-based Linux distributions such as Debian, Ubuntu, Raspbian that use systemd:
```
systemctl enable hivemq
```
Debian > 6.0
```
insserv hivemq
```
CentOS or RHEL
```
chkconfig hivemq on
```

Start HiveMQ Edge

The following instructions show how to start HiveMQ Edge after the installation.

Start HiveMQ Edge manually

Change to the HiveMQ directory:
```
cd /opt/hivemq
```
Execute the startup script:
```
./bin/run.sh
```

Start HiveMQ Edge as daemon

Start the daemon:
```
/etc/init.d/hivemq start
```

Verify that HiveMQ Edge is running

Check if HiveMQ Edge is listening to the default port for MQTT:
```
netstat -an | grep 1883
```
If you run HiveMQ Edge as daemon:
```
/etc/init.d/hivemq status
```

Open Web UI

Once you start a HiveMQ Edge instance, 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.

HiveMQ Edge Installation on Windows Systems

HiveMQ Edge Manual Installation on Windows

Download HiveMQ Edge from the official HiveMQ website.
Use your preferred utility to extract the hivemq-edge-<version>.zip file to C:\hivemq .

HiveMQ Edge Installation as Windows Service

The steps to install HiveMQ Edge as a Windows Service are:

Download the hivemq-windows-service.zip file.
Unzip the hivemq-windows-service.zip file.
Copy the windows-service folder to your HiveMQ home folder.
Open the windows-service folder.
Double-click the installService.bat file.
Reboot

To install a service, you need administrative rights. If you currently lack the correct permission level, right-click the installService.bat file and select Run as administrator.

HiveMQ Edge Startup

The following instructions show how to start HiveMQ Edge after installation:

Double-click the run.bat file.

Keep in mind that a click with the left mouse button (QuickEdit) stops the output of the command line. When you click the command line before Started HiveMQ in xxx ms displays, the HiveMQ startup is interrupted and needs to be continued via a click of the right mouse button. Clicks after the HiveMQ startup finishes have no impact on the execution of HiveMQ.

Check whether HiveMQ Edge is running

To verify that HiveMQ Edge is listening to the default port for MQTT, open the cmd.exe file and enter the following command:

netstat -an | find "1883"