How to install emq on ubuntu?

Following steps will help you setup EMQ X broker on Ubuntu Server.

Click here to view detailed article on how to install erlang on different operating systems.

This article focuses on Ubuntu Server 16.04 LTS, to install erlang on Ubuntu run following command.

Erlang/OTP R19 depends on lksctp-tools library so let’s install it.

Following sections will show how to start, stop, restart and check EMQ X broker services status.

Run the following command to check current status of EMQ X broker service.

Output

Run following command to start EMQ X broker service.

Run the status command as following to verify if service started successfully.

Output

Run following command to stop EMQ X broker service.

Run the status command as following to verify if service stopped successfully.

Output

Run following command to restart EMQ X broker service.

Run the status command as following to verify if service restarted successfully.

Output

Default port for EMQ X Web Dashboard is 18083, to view EMQ X Web Dashboard open following url in any web browser. Please replace IP_ADDRESS with valid IP Address of the machine where you installed the EMQ X broker.

Default credentials for EMQ X Web Dashboard are as following.

Screenshot: EMQ X Web Dashboard Login Screen

Screenshot: EMQ X Web Dashboard UI

Configuration, log and data files are located in following directories.

Following table shows the default TCP Ports used by EMQ X broker.

All of the default TCP ports for EMQ X broker can be configured in etc/emqx.config file.

TCP port for MQTT protocol can be configured using listener.tcp.external property in etc/emqx.config.

SSL Port TCP port for MQTT protocol can be configured using listener.ssl.external property in etc/emqx.config.

Port for External WebSocket listener for MQTT protocol can be configured using listener.ws.external property in etc/emqx.config.

Port for External WebSocket/SSL listener for MQTT Protocol can be configured using listener.wss.external property in etc/emqx.config.

That’s it, hope you enjoyed it. You like this article, have any questions or suggestions please let us know in the comments section.

Thanks and Happy Learning!

Welcome to our EMQ (aka emqtt) how-to series.

EMQ is a distributed, highly scalable and easily extensible MQTT broker written in Erlang. It fully supports MQTT standard 3.1 and 3.1.1.

EMQ can be deployed in single node mode or in cluster mode. Being deployed on proper hardware, a single EMQ node can serve about one million clients. If you are going to deploy it in production, cluster mode is recommended for its high-availability, regardless of the scale of deployment.

EMQ is extensible by plugins. There are several plugins come with default installation. Also, you can write your own plugins.

In this how-to, we will cover the installation, the clustering and the plugins.

You can get the full feature list of EMQ from its github site.

EMQ is packaged as zip package or installation package for different Linux distributions. You can get EMQ from its download page: http://www.emqtt.io/downloads

Installing EMQ is quite straightforward. If you are using a zip package, just unzip it to where you want it to be installed. A zip installtion is quite convenient for development or for multiple installation on same box.

If you are using a Linux installation package, then run the package manage tool on your Linux distribution. This way of installation is recommended for production. To install EMQ using the installation package, you might need the root/sudo privilege.

In some circumstances you might need install lksctp-tools first to satisfy the requirement to run Erlang/OTP.

Here I take the install package for Ubuntu 16.04 as an example:

Now we can start the EMQ:

You can check EMQ’s status at anytime using cli tool:

The EMQ X broker is cross-platform, it can be deployed on Linux, FreeBSD, Mac and Windows.

Each version of the EMQ X broker will release packages of CentOS, Ubuntu, Debian, openSUSE, FreeBSD, macOS, Windows platform and Docker images.

Download address: https://www.emqx.io/downloads (opens new window)

For more information about EMQ X Docker, please check Docker Hub (opens new window) or EMQ X Docker (opens new window) .

EMQ X broker is developed on the Erlang/OTP platform. The project is maintained and managed on GitHub. The source code compilation relies on the Erlang environment and the git client.

Erlang Install: http://www.erlang.org/ (opens new window)

Git client: http://www.git-scm.com/ (opens new window)

Erlang install: http://www.erlang.org/ (opens new window)

scoop install: http://scoop.sh/ (opens new window)

After the scoop is installed, the Git, Make and erlang can be installed using the scoop package management tool.

After the environment is ready, the code can be compiled.

rebar3 install:

After rebar3 is built successfully, add rebar3 path into the environment path of windows

EMQ X Linux General Packages:

Following is a demonstration of installing EMQ X on CentOS:

Use the console mode to check if EMQ X starts normal:

If EMQ X start normal, the output of console shall looks like:

Press CTRL+C to close console.

Start EMQ X as daemon:

Log files can be find under the log/ directory.

Check the EMQ X service’s status:

If EMQ X is started successfully, status check shall return as following:

the status of EMQ X server can also be monitored on the following URL:

• Select the Ubuntu version via emqx.io or github and download the zip package for the EMQ X version to be installed.
• Unzip the package. $ unzip emqx-ubuntu18.04-v3.1.0.zip.
• Start EMQ X. $ ./bin/emqx start emqx 3.1.0 is started successfully! $ ./