HiveMQ Customer Knowledge Base - Self Managed Offering
Welcome to the HiveMQ Customer Knowledge Base for Self-Managed Solutions.
The goal is to help you help yourself. This collection of practical How-To Articles, Recommendations and frequently asked questions will grow over time and aims to provide you with solutions to common challenges, when running a HiveMQ deployment, without the need to create an issue with our technical support.
Categories
Quick Links
Page Tree
- Troubleshooting articles (2)
- License Expiration Alerts with Grafana
- All Articles - Self Managed Offering
- HiveMQ Operator Installation guide
- AWS EKS HiveMQ installation Guide using HiveMQ Operator
- Supporting KBs
- Override the Default logback.xml with the HiveMQ Platform Operator
- Environments
- Prerequisite - Software Packages
- Expose HiveMQ Control Center service using HiveMQ Operator
- Setting up ESE Extension using HiveMQ Operator
- Set up Kafka extension using HiveMQ operator
- Monitoring and Metrics Exporting using HiveMQ Operator
- Expose MQTT port 1883 and test message flow using MQTT CLI
- Add a valid license to HiveMQ Cluster
- Install HiveMQ using Kubernetes Operator
- Azure(AKS) HiveMQ installation Guide using HiveMQ Operator
- Metrics - List of KBs
- Troubleshooting - List of KBs
- MQTT Client Not Receiving Response via Load Balancer
- "Not authorized" Errors and Empty Permissions in Enterprise Security Extension Configuration
- Unable to Connect to HiveMQ from Windows 10 LTSC Client
- Message Dropped - The QoS 0 Memory Limit Exceeded | Troubleshooting
- Keep-Alive Troubleshooting (Clients Disconnected with Reason Code 141 - idle for too long)
- “Not Enough Disk Space” Warning in the HiveMQ Control Center
- Troubleshooting MQTT Client Connection Issues
- Outgoing publish message was dropped. Reason: The QoS 0 memory limit exceeded
- ERROR - Could not open data lock file | HiveMQ Platform Operator (new)
- PVCs permission issues on the data folder with new Platform Operator
- HiveMQ platform operator pod fails to start
- "hivemq" service fails during restart on RedHat Enterprise Linux 8
- Sanity checks take a long time during HiveMQ startup
- MS SQL connection fails for the ESE
- HiveMQ MQTT 5 Client Disconnect Reason Codes
- HiveMQ service fails to start on Ubuntu server boot
- Windows Service Fails to Start
- Restart cluster statefully when join replication process is taking too long
- HiveMQ Kafka Extension - Cluster Authorization Failed / RANGER-3809
- WARN - HiveMQ Enterprise Extension for Kafka: The configuration file is placed at the legacy location
- Could not start Websocket Listener with TLS on port 443
- WARN - No Publish Flow Registered for MqttStatefulPublish with Bridge Extension and ActiveMQ remote broker
- Helm Chart installation fails with error "no matches for kind "PodSecurityPolicy" in version "policy/v1beta1""
- Kubernetes HiveMQ cluster fails to apply CPU cores specified in values.yaml
- Diagnostic Archive generation failed
- "Outgoing publish message was dropped. Receiving consumer: ... "
- No data in Grafana after installing HiveMQ Kubernetes Operator with monitoring
- HiveMQ Kubernetes Operator UPGRADE FAILED: post-upgrade hooks failed: job failed
- "Session expired" message displayed in control center
- ERROR - Not able to create SSL server context. Reason: Not able to open or read KeyStore '/opt/hivemq/conf/xxxxx.p12' with type 'JKS'
- No HiveMQ pods are spawned
- HiveMQ Kubernetes Operator repeatedly shutdown/restarts pods every 2 hours
- Obtaining SSL debugging information
- Known Issues - List of KBs
- ERROR - version `GLIBC_2.27' not found
- Unable to Access Control Center V2 - Required User Permission or License Invalid
- Increased Heap Consumption or Consistently Rising in HiveMQ
- ERROR - HiveMQ Enterprise Security Extension: Unhandled exception in Rest API authentication java.lang.IllegalStateException: No authorization-key set
- ERROR - An error occurred. java.lang.IllegalArgumentException: Comparison method violates its general contract
- Cannot create new topic in Confluent Cloud Kafka cluster
- CVE-2023-39410
- Failed to map segment from shared object
- Error: unable to build kubernetes objects from release manifest: resource mapping not found for name: "swarm-hivemq-swarm" namespace: "swarm" from "": no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"
- No matches for kind PodSecurityPolicy
- Outdated glibc results in ERROR upon startup
- License expiration metric returns faulty value
- Client Event History performance decreases over time
- DNS resolvable host name not accepted in cluster configuration
- KAFKA: Schema Registry TLS uses the keystore password as private key password
- High memory usage in S3 Cluster Discovery Extension 4.1.0
- ERROR - An error occurred while returning credits for client and NPE
- UnsatisfiedLinkError on Windows
- Serialization of kafka metrics failed - Message size to large
- Mandatory valid signature is missing
- WARN - HiveMQ Distribution didn’t contain a build date, please contact support@hivemq.com
- Systemd <=240 version defaults Max open files to 65535
- HiveMQ does not start with OpenJDK 11.0.10+9
- TLS handshake fails without PSK extension
- Persistence directory growing in size
- CVE-2020-13821
- Error starting Micronaut server: Unable to start Micronaut server on port: 443
- MQTTv3 client disconnected with reason: Sent too many concurrent PUBLISH messages.
- Extension could not initialize XML parser
- Too many open files
- Control Center User Permissions not working correctly
- General Information - List of KBs
- HiveMQ Support - Customer Onboarding Readiness Process
- Issue Priorities (HiveMQ Cloud)
- Extension Review and Certification Process
- Response Times
- Expected backup duration
- Issue Priorities
- Shared Subscription Sharding Explained
- Download supported HiveMQ products
- Current Extension and Maven Plugin SDK Version
- Business hours
- FAQ - List of KBs
- Clearing Retained Messages from a Topic
- Why Can't I Use SUB Mode in Bridge Extension with MQTT 3.1.1?
- ControlCenter Connections Count Metric
- What is my IP address?
- Memory consumption is higher after update
- How to set the Kafka consumer max.partition.fetch.bytes
- HiveMQ Edge FAQs
- Why is my queue growing
- terminationGracePeriodSeconds
- Change timezone of the pods
- SAML support in ESE
- HiveMQ Kubernetes Operator Helm chart versions
- Upgrade HiveMQ from version 4.7 to 4.9
- How to configure plugins with HiveMQ 4
- Reason: Dropped message: QoS 0 channel not writable
- Clarification on how licensing works
- Last Will and Testament triggering on Client Take-Over
- Enable or disable extensions while the broker is running
- Apache common text CVE-2022-42889 vulnerability
- Upgrading plugins from HiveMQ 3.x to HiveMQ 4
- Hot-reload of config.xml settings
- onConnectionLost and onServerInitiatedDisconnect event behavior
- Log4Shell vulnerability
- Connection Overload Protection
- Session Expiry and cleanSession flag
- Last Will and Testament information in a cluster
- Retrieving HiveMQ licence information
- Connect and Disconnect Event log message ordering
- Client certificate management
- Disconnect reasons (event.log)
- Recommendations - List of KBs
- Understanding Memory Usage in HiveMQ Deployments
- Understanding Database Caching and When to Modify Cache Settings
- How HiveMQ Enterprise Security Extension Improves Resilience with Caching and Circuit Breakers
- AWS NLB Configuration Recommendations
- Which software versions does HiveMQ recommend?
- Reducing load during a rolling upgrade
- Kubernetes - assign fixed resources for pods
- Recommendations: Heap and memory allocation for the HiveMQ process
- Recommended IOPS for HiveMQ deployments
- How-to articles - List of KBs
- How to Reuse a Static Public IP and DNS Label Across AKS Clusters
- I Want My HiveMQ Logs All to STDOUT
- Reducing Kafka Lag by Increasing Topic Partitions
- How to Resolve HiveMQ License Not Recognized Issues
- How to Receive Retained Messages Using mosquitto_sub vs mqtt-cli
- Implementing a Custom Preprocessor in HiveMQ Enterprise Security Extension (ESE)
- How to Correctly Configure the UNS ISA95 prefixAllTopics Option in HiveMQ Edge 2025.3
- How to Configure Kafka Topic Partitions and Replication per MQTT Mapping in HiveMQ
- Understanding "Client ID: UNKNOWN, IP disconnected ungracefully" in HiveMQ
- How to Add Team Members to the HiveMQ Control Center
- How to Generate a Diagnostic Archive When HiveMQ Control Center UI Is Not Available
- How to Drop Messages in HiveMQ Programmatically
- Troubleshooting Dynamic Topic Permissions with HiveMQ Enterprise Security Extension
- How to Configure Pod Affinity in Kubernetes for High Availability
- 🚧 Workaround for Projected Volumes with HiveMQ Platform on Kubernetes
- Connecting HighByte to HiveMQ Using Non-TLS and TLS Listeners
- ESE Quick Start with File Realm | HiveMQ Platform Kubernetes Operator
- Implementing the Monitoring Dashboard for the HiveMQ Platform Operator
- Disaster recovery runbook for Kubernetes deployment
- How to Use a Private GitHub Repository for HiveMQ Helm Charts with Argo CD
- Creating a Copy of the HiveMQ Docker Image in a Private Docker Repository
- Configuring Private Docker Image Access for HiveMQ Platform Operator
- HiveMQ license and Argo CD Vault Plugin Helm | HiveMQ Platform Operator (new)
- Running HiveMQ as a service on Windows OS
- Configuring HiveMQ Security Extension with Active Directory for MQTT Client Authentication and Authorization
- How to configure ESE to authenticate clients using client certificates and authorize using postgresSQL(without username/password)
- An easy method for installing HiveMQ on Windows OS
- How to Configure Pod Node-Affinity for HiveMQ Platform (new) on Kubernetes
- How to add new Control center user
- How to Configure Pod Anti-Affinity for HiveMQ Platform (new) on Kubernetes
- Deploy Platform Operator via GKE and Expose LB for External Clients
- Pulling Container Image from a Private Repository | HiveMQ Platform Operator (new)
- Forward HiveMQ JMX metrics to DataDog | HiveMQ Platform Operator (new)
- Inject license via Hashicorp Vault Agent Init Container | HiveMQ Platform Operator (new)
- Inject license via Hashicorp Vault Agent Annotations | HiveMQ Platform Operator (new)
- How to monitor HiveMQ Enterprise Extension for Kafka
- Running HiveMQ Edge as a service on Windows OS
- Setting Up HiveMQ Kafka Extension for Redpanda Cluster Connectivity
- How to isolate a node from the cluster
- Scrape prometheus metrics on EC2 instance using HiveMQ Prometheus Extension
- HiveMQ Installation Guide - Windows Server 2022 on AWS
- Inject license via Hashicorp Vault Agent | HiveMQ Operator (legacy)
- MQTT Message Log Extension Log File Configuration
- Health API with legacy HiveMQ Kubernetes Operator
- Downloading HiveMQ Enterprise Extension SDK Packages
- HiveMQ Platform operator(new)
- Setting up HiveMQ Bridge extension with mTLS enabled using HiveMQ Platform Operator (new)
- Configuring Environment Variables in HiveMQ Platform using Helm
- How to access MQTT, Websocket ports using TransportServer/VirtualServer resource with nginx ingress controller
- Configuring the HiveMQ Platform for One Pod per Kubernetes Node
- External Secrets from Hashicorp Vault | HiveMQ Platform Operator (new)
- Consul-template sidecar | HiveMQ Platform Operator (new)
- Declared Shared Subscriptions Configuration on HiveMQ Platform
- Setting Up Enterprise Kafka Extension with HiveMQ Platform Operator
- Setting Up Enterprise PostgreSQL Extension with HiveMQ Platform Operator
- Overriding HiveMQ's Config.xml with HiveMQ Platform Operator
- Setting Up Enterprise Security Extension(Postgres) with HiveMQ Platform Operator
- Setting Up HiveMQ License for Your HiveMQ Cluster using HiveMQ Platform Operator
- Overide logback.xml for custom extension
- JMX Metrics Quick Access with Java
- Enhancing HiveMQ Custom Extensions: Listener-Based Authentication
- Setting up Grafana for HiveMQ Monitoring in Kubernetes
- Setting up Prometheus for HiveMQ Monitoring in Kubernetes
- Monitoring HiveMQ Swarm Instances with HiveMQ Operator and Prometheus
- Utilizing a ConfigMap with File-Based RBAC Extension
- Setup TLS listener for Hivemq cluster using HiveMQ platform operator (new)
- Deploy HiveMQ using the HiveMQ Operator in an AKS cluster, and set up a load balancer with a static public IP.
- Setting Grafana as LoadBalancer in Kubernetes with HiveMQ Operator
- Setting or Updating the Grafana Admin Password in Kubernetes with HiveMQ Operator
- Overriding the logback.xml file in HiveMQ Operator
- The modifications made to the ConfigMap do not take effect on the active hivemq cluster when utilizing the hivemq operator.
- Restart a cluster best practice
- ESE Configuration in a Secret
- ESE Configuration in a ConfigMap
- Trigger the Diagnostic Archive via file
- X.509 certificate with subject alternative name (SAN)
- Using File RBAC and Enterprise security extension together
- Use Heartbeat extension with HiveMQ Kubernetes Operator
- Export HiveMQ Metrics from either Prometheus or a Grafana Datasource
- Enable Prometheus and Grafana monitoring
- Set the HiveMQ License File from a Kubernetes Secret
- Setting Up a HiveMQ Cluster with StatefulSet and Persistent Volumes in Kubernetes
- How to configure ESE to use Certificates Authentication
- Disaster recovery runbook for EC2/VM instances
- Find Grafana Datasource ID by Name
- Regular expressions in Trace Recording filters
- How to setup bridge extension using HiveMQ operator
- Expose HiveMQ Prometheus metrics in DataDog using the HiveMQ operator
- How to upgrade HiveMQ and Operator versions
- Starting from Kubernetes API version 1.25, PodSecurityPolicy will no longer be served.
- Kubernetes API v1.22 migration
- Setup TLS Offloading & PROXY Protocol for HAProxy and NGINX
- Test Expired Messages
- How to create and configure AWS NLB
- Upload file to the customer support portal
- How to set secrets and use with environment variables while using Hivemq operator.
- Expose HiveMQ JMX metrics for DataDog in Kubernetes
- Expose the HiveMQ Control Center and Rest API using Ingress
- Upgrading both HiveMQ version 4.6.4 and the k8s operator version 0.9.0
- Setup ESE with Postgres using k8s operator
- How to change log level at runtime
- Set custom variables using Kubernetes Legacy HiveMQ operator
- Add custom annotations in Legacy HiveMQ Kubernetes operator
- Get information about file descriptors used by system
- Using multiple listeners in Kubernetes
- Using an Async Profiler to create a flame-graph
- How to find subscriptions of a specific client
- Using regular expressions in Trace Recordings
- Create Trace Recordings for a shared subscription
- Configuring separate log files for extensions
- Using SSL client certificates with mqtt-client
- Creating self-signed server- and client certificates with Root CA intermediate certificates.
- [Outdated] Running HiveMQ as a service on Windows
- Force a heap-dump
- Creating a thread dump series
- HiveMQ Cluster with mutual TLS on a local machine
- Starting HiveMQ in cluster mode with persistent data
- Instaling Java 11 on Windows
- HiveMQ Operator Installation guide
- Articles by Labels