EMQ Sponsors Open Source Summit Europe 2024 | Register Now →

How to Deploy EMQX Enterprise on Google Cloud

Guowei Li
Apr 13, 2023
How to Deploy EMQX Enterprise on Google Cloud

Google Cloud IoT Core will be retired on August 16, 2023. As this date approaches, many users are looking for new solutions for their existing IoT businesses, and EMQX Enterprise is an ideal choice to achieve this goal.

EMQX Enterprise is a large-scale distributed MQTT messaging platform that can be deployed on the Google Cloud Platform (GCP) in multiple ways. You can easily and quickly migrate your devices on IoT Core to EMQX Enterprise and then continue to integrate with your data services in GCP, without affecting the existing business.

To migrate your business from IoT Core to EMQX Enterprise, you basically have three steps to go:

  1. Create an EMQX cluster on GCP.

  2. Connect your devices to EMQX cluster.

  3. Integrate your data with GCP Pub/Sub.

To start with, this article will guide you through the process of deploying EMQX Enterprise on GCP and then test the publishing and subscription of the migrated services.

GCP IoT Core Migration

Create a Virtual Machine Instance on GCP

Before deploying EMQX enterprise, let’s first create a Virtual Machine on GCP.

GCP Virtual Machine Instances allow users to easily deploy and manage applications without creating and managing servers locally.

Here are the steps for creating a VM instance on GCP. You can also refer to the Create and start a VM instance guide.

  1. Log in to the GCP console and click Create a VM.

    Click Create a VM

  2. If you have not created a VM instance before, you will be redirected to the Compute Engine API page. Click ENABLE to enable the Compute Engine API and continue with the creation process.

    Click ENABLE

  3. Check the New VM instance option to start the instance configuration

    Choose an appropriate region and zone and machine configuration. In Machine configuration, select E2 for Series and Custom for Machine type, and allocate 2 vCPUs and 4GB of memory. With this specification, a single EMQX node can handle up to 10,000 MQTT connections and a maximum of 5,000 TPS of concurrent messages.

    Machine Configuration

    In the Boot disk configuration, select the Ubuntu 20.04 LTS operating system and change the disk size to 30GB.

    Machine Configuration

    Boot disk

  4. Keep the rest of the configurations as default, and click CREATE to start the creating process.

Install EMQX Enterprise

We will deploy EMQX Enterprise with the SSH tool from GCP. Before that, we need to get the download address and installation command from the EMQX website.

In this example, we will deploy EMQX 4.4.16 on Ubuntu 20.04, with an amd64 CPU architecture. You can go to the page Download EMQX Enterprise to get the required information.

Download EMQX Enterprise

Download EMQX Enterprise

  1. Log in to the GCP console and click Navigation menuPRODUCTSCOMPUTECompute EngineVM Instances to enter the list of VM instances.

    VM Instances

  2. Find the VM instance you created and you will see that GCP has assigned a unique external IP address to it. Click on SSH to open your SSH terminal.

    Click SSH

  3. In the SSH terminal, enter the root directory and follow the installation commands provided on the download page.

    To enter the root directory, you can use the following command:

    sudo su
    cd ../../

    Download EMQX Enterprise using the wget:


    Wget EMQX

    Install EMQX Enterprise:

    sudo apt install ./emqx-ee-4.4.16-otp24.3.4.2-1-ubuntu20.04-amd64.deb

    Install EMQX Enterprise:

    Start EMQX Enterprise:

    sudo systemctl start emqx

    Congratulations! You have completed the installation of EMQX Enterprise on the GCP VM instance.

Opening Firewall Ports on GCP

After you have installed the service or application on GCP, you need to manually open the required ports to access it from outside. Follow these steps to open the required ports on GCP.

  1. Log in to the GCP console and click Navigation menuPRODUCTSVPC networkFirewall to enter the Firewall page.




  3. Fill in the following fields to create a firewall rule:

    • Name: Enter a name for the rule.
    • Network: Select default.
    • Priority: Enter a priority number. The lower the number, the higher the priority. Enter 1000 here.
    • Direction of traffic: Select Ingress, which means receiving data on specific ports.
    • Action on match: Select Allow to allow traffic to pass through.
    • Targets: Select All instances in the network to apply the rule to all instances in the network.
    • Source filter: Choose the source filter as IPv4 ranges if you want to receive data from all networks or users.
    • Source IPv4 ranges: IP address means that anyone can send data. You can also configure rules to receive data from specific IP addresses.
    • Protocols and ports: If you want to open all ports, select Allow all. Otherwise, open the specified TCP ports. You can open multiple ports simultaneously by separating them with commas. Here, enter 1883, 8883, 8083, 8084, 18083, and 8081.

    Firewall rule

  4. Click CREATE to create the firewall rule. You will see the rule you created in the list.

    Firewall rule

Quick Test with MQTTX Client

Now you have completed the installation of EMQX Enterprise on GCP and opened all the required ports. Here are the connection details:

Server address
Please replace it with your actual VM Instance public IP address.
TCP Port 1883
WebSocket Port 8083
SSL/TLS Port 8883
WebSocket SSL/TLS Port 8084
Dashboard Port 18083
REST API Port 8081

We will use MQTTX to simulate the access of IoT MQTT devices and quickly test whether the server is available.

MQTTX is a cross-platform MQTT 5.0 client tool open-sourced by EMQ. It supports macOS, Linux, and Windows, has rich features, and allows you to easily test MQTT/TCP, MQTT/TLS, and MQTT/WebSocket connections through MQTTX's one-click connection method and graphical interface.

MQTTX Web is the browser version of MQTTX, which eliminates the need for downloading and installation. You can quickly connect to the MQTT server via WebSocket by simply opening the browser.

  1. Access the MQTTX Web page and click New Connection or the + icon on the menu bar to create a connection.

    New Connection

  2. To configure and establish an MQTT connection, you only need to configure:

    • Name: Connection name, such as GCP EMQX Enterprise.
    • Host:
      • Select the connection type as ws://, as MQTTX Web only supports WebSocket protocol. If you want to test SSL/TLS authentication connections, please download the MQTTX client
      • Enter the VM instance public IP address.
    • Port: 8083, which is the port corresponding to the WebSockets protocol.

    Leave other options at their default settings. You can keep the default settings for the rest fields or set as per your business needs. The corresponding configuration instructions can be found in the MQTTX Manual - Quick Connect.

    After configuration, click Connect in the upper right corner of the page to establish the connection.

    Click Connect

  3. Subscribe to a topic and publish a message to complete the message publish/subscribe test.

    • Click New Subscription, enter testtopic/1 in the pop-up box, and subscribe to it.
    • Enter testtopic/1 as the topic in the message-sending box, and use default values for other fields.
    • Click the send button at the lower right corner of the Payload input box, and the message will be successfully sent in the chat window.
    • Almost simultaneously, a new message will be received in the chat window, indicating that the publish/subscribe test has been completed.

    Publish/subscribe testing

    After completing device connection and message publish/subscribe testing, you can also open the EMQX Dashboard in your browser by visiting http://<ip>:18083 and logging in with the default credentials: username admin and password public.

    On the Dashboard, you can easily manage and monitor EMQX, manage the device list, and configure various functions such as security and data integration.

    MQTT Dashboard


Now we have learned how to deploy EMQX Enterprise on GCP. To use EMQX Enterprise in production, we suggest you continue to create an EMQX cluster through the VPC network for better scalability and availability.

In addition to manual installation, you can also deploy EMQX Enterprise on GCP through EMQX Kubernetes Operator and EMQX Terraform. We also highly recommend the fully managed MQTT message cloud service EMQX Cloud.

In the following blogs, we will introduce how to migrate devices from GCP IoT Core to EMQX Enterprise, and how to seamlessly migrate IoT Core services through the GCP Pub/Sub integration of EMQX Enterprise.

Try EMQX Enterprise for Free
Get Started →

Related Posts