HiveMQ Cloud Console

The HiveMQ Cloud console is the center of operations for all your cloud-related activities:

  • View your home screen for the latest HiveMQ-related news

  • Create, manage, and track your HiveMQ Cloud clusters

  • Edit the credentials and permissions that allow access to your HiveMQ Cloud cluster

  • Integrate your HiveMQ Cloud instance with popular data streaming services.

  • Access your HiveMQ Cloud account information

Sign Up / Log In

The first time you use HiveMQ Cloud, you need to create your login credentials. To get started, navigate to console.hivemq.cloud:

HiveMQ Cloud Console Log In
  1. Switch to the Sign Up tab of the HiveMQ Cloud login dialog.

  2. Enter your email and create a password, or use your GitHub, Google, or LinkedIn account to sign up.

  3. Agree to the HiveMQ terms of service and privacy policy and select Continue.
    HiveMQ Cloud automatically sends a confirmation email to the email address that you provided.

  4. To verify your new account, click the link in the confirmation email. The link verifies your account and returns you to the HiveMQ Cloud login screen.

If you do not receive a confirmation email, contact cloud@hivemq.com and ask us to send the email again.

After your initial sign-up, you can log in to HiveMQ Cloud directly.

  1. Switch to the Log In tab of the HiveMQ Cloud login dialog.

  2. Enter the email address and password or account that you provided on sign up and select Log In.
    Your HiveMQ Cloud console opens.

The first time you log in, you are asked for contact details. Fill in the contact form and select Continue.

If you forget your password, use the Don’t remember your password option to create a new password. After a verification email, a Change Password dialog where you can create a new password is provided. A notification window confirms that your password is successfully updated.
Return to the Log In tab, enter your new password, and select Log In.

HiveMQ Cloud Clusters

HiveMQ Cloud offers different packages to fit your needs perfectly.
The HiveMQ Cloud cluster package you select determines the features, usage limits, and price of your cluster:

To compare HiveMQ Cloud packages and benefits, take a look at the HiveMQ Cloud product overview.
If you are new to HiveMQ Cloud and need some help to get started, check out our HiveMQ Cloud Quick Start Guide.

Create Cluster

You can create additional HiveMQ clusters at any time. Pricing and features as shown.

Once you sign up and log in to HiveMQ Cloud, you can select the type of HiveMQ Cloud cluster you want to create.

  1. Based on the pricing and usage information, select the plan that is right for your individual use case.
    For additional information, expand the Compare Features section of the plan selection page.

    Cluster Creation Wizard
  2. Select Get Started for the HiveMQ Cloud Serverless plan or Get Started FREE for the HiveMQ Starter plan. For step-by-step instructions on how to set up a Serverless cluster, see our HiveMQ Cloud Quick Start Guide.

    The HiveMQ Cloud Starter plan offers a 15-day free trial with no credit card required. After your trial ends, you will be charged based on your usage at the end of each billing cycle. You can cancel your plan at any time.
  3. When you select the HiveMQ Cloud Starter plan, a page to enter basic information, review plan details, and select the cloud service provider where you want to host your HiveMQ Cloud cluster opens.
    Follow the prompts to configure your cluster on the selected service provider.
    Select Continue to save your information and open a page to confirm your billing information:

    Select Service Provider
  4. Enter or review your billing information, check the Terms of Service, and select Start trial to create your HiveMQ Cloud Starter cluster.

    HiveMq Cloud Starter Plan Billing
    After your trial ends, you will be charged based on your usage at the end of each billing cycle starting on the date shown. You can cancel your HiveMQ Cloud plan at any time.
    To review the billing terms and conditions that apply to each plan see, Billing.
  5. Your new HiveMQ Cloud Starter cluster appears on the Your Clusters overview.

Your Clusters

The Your Clusters page of your HiveMQ Cloud console lists all active clusters on your account and gives you quick access to everything you need to manage your HiveMQ Cloud clusters.

To view the Cluster Details page of a specific cluster, select the Manage Cluster action on the card of the desired cluster.
Your Clusters

The cards on the Your Clusters page provide basic information and actions for each of your active HiveMQ Cloud clusters:

Item Description

URL

The unique URL of the cluster that HiveMQ generates automatically when the cluster is created.

Port (TLS)

The secure port that your MQTT clients use to connect to your HiveMQ cluster.

Status

The current state of the HiveMQ Cloud cluster.

Started

The timestamp when the HiveMQ Cloud cluster was created.

Available Actions

Item Description

Create New Cluster

Opens a dialog to create a new HiveMQ Cloud cluster.

Manage Cluster

Opens the Cluster Details page for the selected HiveMQ cluster. Cluster details are available for each running cluster. The information provided on the cluster details overview varies based on the HiveMQ Cloud plan.

Cluster Details - HiveMQ Cloud Starter Plan

The Cluster Details page of your HiveMQ Cloud cluster provides information and access management options for the selected cluster.

Use the Manage Cluster actions on the Your Clusters page to open the Cluster Details of a specific cluster.

Cluster Details Overview - HiveMQ Cloud Starter Plan

The Overview tab of the Cluster Details page outlines key information for the selected cluster.

The information and actions available on the Overview tab of the Cluster Details page vary based on the HiveMQ Cloud plan type of the cluster.
Cluster Details - HiveMQ Cloud Starter Plan

Cluster Information - HiveMQ Cloud Starter Plan

Item Description

Current Plan

The type of HiveMQ Cloud package the cluster runs. The following cluster types are possible:

  • Free

  • Starter

  • Professional

  • Enterprise

Region

The geographical location of the data center on which the cluster runs.

Cloud Provider

The cloud service provider on which the HiveMQ Cloud cluster is located. The following providers are available:

  • Amazon Web Services (AWS)

  • Azure

Current Tier

The subscription model of the selected plan. The available tiers vary based on the type of plan. The following tiers are possible:

  • FREE (Serverless plan only)

  • Production S (Starter plan only)

Name

The identifier of the selected cluster.

Integrations

The service integrations that are currently configured for the selected cluster. The following fully-managed integrations are available:

  • Confluent Cloud

  • Amazon Kinesis

Connection Settings - HiveMQ Cloud Starter Plan

Item Description

Cluster URL

The unique URL of the cluster that HiveMQ generates automatically when the cluster is created.

Port

The secure port that your MQTT clients use to connect to your HiveMQ Cloud cluster.

WebSocket Port

The secure port that your MQTT clients use to connect to your HiveMQ Cloud cluster using WebSocket.

Available Actions

Item Description

Update Usage

Manually refreshes MQTT Client Sessions and Data Traffic information.

Edit Cluster URL

Opens a dialog where you can define a custom cluster URL for the selected cluster (Pay As You Go package only). Maximum one change per 24-hour period.
The autogenerated URL of your cluster remains available. MQTT clients that are connected to your automatically generated URL remain connected.

Change Plan to Pay as You Go

Opens a dialog to upgrade your Free HiveMQ Cloud cluster to a Pay As You Go cluster (credit card required).

Delete Cluster

After a confirmation request, this action permanently deletes the HiveMQ cloud cluster and all data on the cluster. This action cannot be undone.

Item Description

MQTT Client Sessions

The current number of MQTT connections used in this billing period and the maximum number of concurrent MQTT connections the selected HiveMQ Cloud cluster allows. Actual usage can vary slightly from the cluster capacity value shown.

Data Traffic

The current volume of data consumed in this billing period and the total volume of data the selected HiveMQ Cloud package includes per month. Actual usage can vary slightly from the cluster capacity value shown.

It is not possible to downgrade your HiveMQ Cloud Pay As You Go to a Free HiveMQ Cloud cluster.

Access Management

The Access Management tab is where you can add, view, and edit the MQTT credentials that permit clients to connect to the selected cluster.
You can adjust these credentials as needed to fulfill your individual use case.

To locate the Access Management, go to Your Clusters and select Manage Cluster for the desired cluster.
On the Cluster Details page that opens, switch to the Access Management tab.

Access Credentials

To connect an MQTT client to your cluster, you need to define the MQTT credentials that allow the client to access the cluster.

You manage access to your HiveMQ Cloud cluster by creating various sets of credentials your MQTT clients can use.
Only clients that present known credentials are allowed to connect and perform actions on the cluster.

Access Management Overview

Create MQTT Client Credentials

MQTT client credentials contain a username-password pair. MQTT clients use the credentials you define to connect to your HiveMQ Cloud broker.

You can add and delete MQTT credentials for your HiveMQ Cloud cluster as needed.

When you remove credentials, clients that are currently connected with the credentials remain connected. During the next reconnect, the clients will no longer be able to connect to the cluster with the old credentials.

To create an MQTT credential, enter a Username and Password in the Credentials area of the Access Management tab of your running HiveMQ Cloud cluster and select Add.

To locate the Credentials area, go to Your Clusters and select Manage Cluster for the desired cluster. On the Cluster Details page that opens, switch to the Access Management tab.

The Access Credentials area of the Access Management tab automatically adjusts to display the changes that you make.

Access Management - MQTT Credentials

Each set of credentials includes an associated permission level that controls the type of actions clients that connect with the credentials can perform.
Three permission levels are available:

  • Publish and subscribe: Allows the client to publish and receive MQTT messages.

  • Subscribe only: Allows the client to receive MQTT messages.

  • Publish only: Allows the client to publish MQTT messages.

All currently available MQTT credentials for the selected cluster are listed in the Access Credentials area of the Access Management tab.

Integrations

HiveMQ Cloud provides out-of-the-box, fully managed integrations that let you instantly connect your MQTT broker to popular services. HiveMQ Cloud integrations offer a simple and straightforward way to configure data streaming between HiveMQ Cloud and the service of your choice without ongoing operational burden.

For an overview of HiveMQ Cloud integrations that are currently under construction or to suggest additional integrations, visit the Integrations tab of your HiveMQ Cloud console.

HiveMQ Cloud Apache Kafka Integrations

Apache Kafka is an open-source streaming platform that is widely used for real-time data pipelines, streaming analytics, and data integration at scale. MQTT and Kafka are frequently used together to enhance the functionality of IoT and machine-to-machine communications.
Common use cases include the following:

  • Data collection: Transmit MQTT data from IoT devices to a Kafka broker for further processing in a system of your choice.

  • Real-time processing: MQTT and Kafka are used to build scalable real-time data processing pipelines that can process large amounts of incoming data from IoT devices.

HiveMQ Cloud offers three fully managed Kafka streaming integrations:

  • Kafka: Stream data between your HiveMQ Cloud broker and the Apache Kafka cluster of your choice.

  • Confluent Cloud: Stream data between your HiveMQ Cloud broker and your Confluent Cloud Kafka cluster.

  • Aiven: Stream data between your HiveMQ Cloud broker and your Aiven Kafka cluster.

HiceMQ Cloud Integrations
To set up an integration, go to Your Clusters and select Manage Cluster for the desired cluster. On the Cluster Details page that opens, switch to the Integrations tab.

Kafka Integration

The HiveMQ Cloud Kafka integration makes it possible to move MQTT messages bidirectionally between HiveMQ Cloud and your existing Apache Kafka cluster.

  • On the Integrations tab, select Configure on the Kafka card.
    A page to enter your Kafka Streaming Configuration opens.

Kafka Connection
Kafka Connection Config

This area defines how HiveMQ Cloud connects to a Kafka cluster of your choice:

Kafka Connection Config
  • In the Bootstrap servers section, enter one or more bootstrap server URLs for the Kafka cluster to which you want your HiveMQ Cloud broker to connect. Use the format host:port. To add multiple server URLs, use a comma-separated string with the format host:port,host:port,…​.

  • In the Connection security section, enter your Kafka credentials to secure the connection between HiveMQ Cloud and Kafka.

  • In the SASL mechanism section, select the Simple Authentication and Security Layer (SASL) mechanism your Kafka cluster uses to authenticate clients. Two options are possible:

    • PLAIN (default)

    • SCRAM-SHA-512

      When you change the SASL mechanism, the Kafka username and password that you entered are reset.
Topic Mapping

The Topic Mapping area of the Kafka Streaming Configuration defines the bidirectional data flow between your HiveMQ Cloud cluster and Apache Kafka:

HiveMQ to Kafka Mapping
  • Select HiveMQ to Kafka to define the source MQTT topic from which you want to forward messages to your Kafka cluster.
    The Kafka integration automatically forwards all messages published with the source MQTT topic to the Kafka topic that you specify in the destination topic input field. Both fields are required.

HiveMQ to Kafka Mapping
  • Select Kafka to HiveMQ to define the source Kafka topic from which you want to forward messages to your MQTT clients.
    The Kafka integration automatically publishes each new message from your specified source topic in Kafka to your HiveMQ broker with the MQTT topic you define in the destination topic input field. Both fields are required.

The HiveMQ Cloud Kafka integration supports a throughput of up to 250 MB per second. Messages are sent with QoS 0 by default.
  • To save your configuration and enable the integration, select Enable.

Confluent Cloud Integration

The HiveMQ Cloud Confluent Cloud Kafka integration makes it possible to move MQTT messages bidirectionally between HiveMQ Cloud and your existing Confluent Cloud Kafka cluster.

  • On the Integrations tab, select Configure on the Confluent card.
    A page to enter your Confluent Cloud Streaming Configuration opens.

Confluent Cloud Streaming Configuration
Confluent Connection Config

This area defines how HiveMQ Cloud connects to the selected Confluent Cloud Kafka cluster:

Confluent Connection Config
  • In the Bootstrap servers section, enter one or more bootstrap server URLs for the Kafka cluster to which you want your HiveMQ Cloud broker to connect. Use the format host:port. To add multiple server URLs, use a comma-separated string with the format host:port,host:port,…​.

  • In the Connection security section, enter your Kafka credentials to secure the connection between HiveMQ Cloud and Kafka.

You do not need to select a SASL mechanism. Confluent handles the related settings automatically
Topic Mapping

The Topic Mapping area of the Confluent Cloud Streaming Configuration defines the bidirectional data flow between your HiveMQ Cloud cluster and your Confluent Cloud Kafka cluster:

HiveMQ to Kafka Mapping
  • Select HiveMQ to Kafka to define the source MQTT topic from which you want to forward messages to your Kafka cluster.
    The Confluent integration automatically forwards all messages published with the source MQTT topic to the Kafka topic that you specify in the destination topic input field. Both fields are required.

HiveMQ to Kafka Mapping
  • Select Kafka to HiveMQ to define the source Kafka topic from which you want to forward messages to your MQTT clients.
    The Confluent integration automatically publishes each new message from your specified source topic in Kafka to your HiveMQ broker with the MQTT topic you define in the destination topic input field. Both fields are required.

The HiveMQ Cloud Kafka integration supports a throughput of up to 250 MB per second. Messages are sent with QoS 0 by default.
  • To save your configuration and enable the integration, select Enable.

Aiven Integration

The HiveMQ Cloud Aiven Kafka integration makes it possible to move MQTT messages bidirectionally between HiveMQ Cloud and your existing Aiven service.

  • On the Integrations tab, select Configure on the Aiven card.
    A page to enter your Aiven Kafka Streaming Configuration opens.

Aiven Kafka Streaming Configuration
Aiven Connection Config

This area defines how HiveMQ Cloud connects to the selected Aiven Cloud Kafka cluster:

Aiven Connection Config
  • In the Bootstrap servers section, enter one or more bootstrap server URLs for the Kafka cluster to which you want your HiveMQ Cloud broker to connect. Use the format host:port. To add multiple server URLs, use a comma-separated string with the format host:port,host:port,…​.

  • In the Connection security section, enter your Kafka credentials to secure the connection between HiveMQ Cloud and Kafka.

  • In the Certificate authority section, add an Aiven certificate authority file to connect your HiveMQ broker securely to your Kafka cluster. You can download the necessary file through the Aiven web console.

Topic Mapping

The Topic Mapping area of the Aiven Kafka Streaming Configuration defines the bidirectional data flow between your HiveMQ Cloud cluster and your Aiven Kafka cluster:

HiveMQ to Kafka Mapping
  • Select HiveMQ to Kafka to define the source MQTT topic from which you want to forward messages to your Kafka cluster.
    The Aiven integration automatically forwards all messages published with the source MQTT topic to the Kafka topic that you specify in the destination topic input field. Both fields are required.

HiveMQ to Kafka Mapping
  • Select Kafka to HiveMQ to define the source Kafka topic from which you want to forward messages to your MQTT clients.
    The Aiven integration automatically publishes each new message from your specified source topic in Kafka to your HiveMQ broker with the MQTT topic you define in the destination topic input field. Both fields are required.

The HiveMQ Cloud Kafka integration supports a throughput of up to 250 MB per second. Messages are sent with QoS 0 by default.
  • To save your configuration and enable the integration, select Enable.

HiveMQ Cloud API Tokens

The HiveMQ Cloud REST API gives you the ability to customize permissions to suit your needs and automate numerous actions. For more information, see HiveMQ Cloud REST API.

Currently, the HiveMQ REST API is available for use with the HiveMQ Cloud Starter plan only.

Programmatic access to the HiveMQ Cloud API requires an API token.

Create HiveMQ Cloud API Token

To create an API token for your Starter cluster, select API Tokens in the main navigation:

Create HiveMQ Cloud API Token
  1. Follow the prompts to fill in all necessary information and select Create API Token.

  2. Copy and save the generated API token.

Make sure to copy your HiveMQ Cloud API token. Once you leave the page, you will not be able to view the content of the API token again!

Edit HiveMQ Cloud API Token

To view, edit, or delete your existing HiveMQ Cloud API tokens, select API Tokens in the main navigation.

A list of your currently available HiveMQ Cloud API Tokens opens:

Edit HiveMQ Cloud API Tokens
  1. Select Edit for the desired HiveMQ Cloud API token and enter your changes.

Billing

The Billing page of the HiveMQ Cloud console provides detailed information on all current and previous charges to your HiveMQ Cloud account. Charges do not include state or local taxes.

If you have not yet created a cluster and entered your payment information, a form to enter credit card information displays on the Billing page. After you enter your credit card information, the credit card input form no longer displays. To request changes to your payment information, contact cloud@hivemq.com.

Upcoming Invoice

In the Upcoming Invoice area, you can view your month-to-date costs and a detailed breakdown of the current usage charges for each of your clusters.

HiveMQ Cloud features a transparent pricing structure that is easy to calculate. You only pay for the services you use and there are no additional costs or termination fees.

The charges for each of your HiveMQ Cloud clusters vary based on the cluster type:

  • Pay As You Go: HiveMQ charges you monthly in accordance with the applicable HiveMQ SaaS Terms. You are charged for the maximum number of MQTT client sessions that are active per month ($ 0.10 / MQTT client session) and the data traffic ($0.15 / started GB) that you route via your cluster.

Data usage that exceeds the 100 GB of free data per month per cluster is charged at $0.15 per started GB.

At the end of the month, the calculation of total hours and total data usage rounds up to the nearest whole number. For example, 75 minutes of run time equals 2 hours of usage. After the 100 GB of free data in a monthly billing period, 850 MB of additional data equals 1 GB of billable data usage (US $0.15).

Available Upcoming Invoice Information

Item Description

Period

Shows the month in which the cost of services you are using are currently being incurred.

Clusters

Shows the total number of clusters to date that were active on your HiveMQ Cloud account in the current billing period. This total includes clusters that were deleted in the current period.

Usage

Shows the total hours to date of run time for all of your clusters in the current billing period.

Traffic

Shows the total volume to date of billable data traffic from all of your clusters in the current billing period. If your HiveMQ Cloud cluster includes free traffic per month, only the traffic volume that exceeds that amount appears here.

Total

Shows the total cost of your HiveMQ Cloud account to date in the current billing period.

Upcoming Invoice Details:
Item Description

Name

The identifier of the selected cluster.

State

Shows the status of the cluster for billing purposes. The following states are possible:

  • Active: The cluster is currently running.

  • Inactive: The cluster was deleted.

Usage

Shows a breakdown of the total usage for each cluster in the billing period. The following usage details are provided:

  • Usage: The total runtime in hours for each cluster in the billing period.

  • Cost: The price per hour to run the cluster.

  • Price: The total usage cost for each cluster in the billing period.

Traffic

Shows a breakdown of the billable data volume for each cluster in the billing period. The following usage details are provided:

  • Usage: The total volume of data over the 100 GB of free data that the cluster used in the billing period.

  • Cost: The price per GB for data after the 100 GB of free data per month ($0.15 per started GB over the 100 GB free limit).

  • Price: The total cost of data over the 100 GB of free data that the cluster used in the billing period.

Previous Invoices

The Previous Invoices area provides a complete history of your cost and usage on HiveMQ Cloud.

Available Previous Invoices Information

Item Description

Period

The month in which the cost of services were incurred.

Clusters

The total number of clusters that were active in the billing period.

Usage

The total usage in hours for all clusters in the billing period.

Traffic

The total amount of billable traffic above the 100 GB free traffic per cluster in the billing period ($0.15 per started GB over the 100 GB free limit).

Total

The total charges for all your clusters in the selected billing period.

Invoice

A link to download a pdf of the invoice for the selected billing period.

Previous Invoices (expanded view)

Item Description

Name

The identifier of each cluster in the billing period.

State

The status of the cluster for billing purposes. The following states are possible:

  • Active: The cluster is currently running.

  • Inactive: The cluster was deleted.

Usage

Shows a breakdown of the total usage for each cluster in the billing period. The following usage details are provided:

  • Usage: The total runtime in hours for each cluster in the billing period.

  • Cost: The price per hour to run the cluster.

  • Price: The total usage cost for each cluster in the billing period.

Traffic

Shows a breakdown of the billable data volume for each cluster in the billing period.

  • Usage: The total volume of data over the 100 GB of free data that the cluster used in the billing period.

  • Cost: The price per GB for data after the 100 GB of free data per month ($0.15 per started GB over the 100 GB free limit).

  • Price: The total cost of data over the 100 GB of free data that the cluster used in the billing period.

Help

If you want more information or need assistance with HiveMQ Cloud, we are always happy to help. Here are some ways to learn more about HiveMQ and HiveMQ Cloud:

  • To learn more about all the products and services HiveMQ offers take a look at the HiveMQ User Guide and visit the HiveMQ website.

  • For additional assistance, log in to your HiveMQ Cloud account, click Help in the main navigation, and select Contact Support to access the HiveMQ Cloud Support Portal.