Start EMQX

Start EMQX broker in the background

$ emqx start
EMQX Broker v4.0.0 is started successfully!

systemctl start

$ sudo systemctl start emqx
EMQX Broker v4.0.0 is started successfully!

service start

$ sudo service emqx start
EMQX Broker v4.0.0 is started successfully!

TIP

If you are using EMQX Enterprise, you need to import a license to use it. For the import steps, see Start EMQX Enterprise below.

EMQX Broker installed via ZIP archive does not support systemctl and service startup.

Check the status of EMQX Broker

EMQX Broker starts normally:

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

EMQX Broker failed to start normally:

$ emqx_ctl status
Node 'emqx@127.0.0.1' not responding to pings。

You can check the log file from logs and confirm whether it belongs to Common Error.

Request a trial license

EMQX Enterprise requires a license file to start normally. EMQX Broker can skip this step.

1. Visit the EMQX Enterprise download page, click Get FREE Trial License.

   

2. Register to log in and apply for a trial license file, then download the license file.

   

3. Replace the license file (etc/emqx.lic) in the default certificate directory. You can also choose to change the read path of the certificate file, modify license.file in the etc/emqx.conf file, and make sure that the license file is in the updated read path and EMQX Enterprise has read permission. Then, start EMQX Enterprise. EMQX Enterprise is started in the same way as EMQX Broker, which can be seen below.

4. If the running EMQX Enterprise needs to update the license file, you can use the emqx_ctl license reload [path of the license file] command to directly update the license file without restarting EMQX Enterprise. It should be noted that the certificate loaded by the emqx_ctl license reload command will only take effect during this run of EMQX Enterprise. If you need to permanently update the license certificate path, you still need to replace the old certificate or modify the configuration file, which can be seen from the previous step.

DANGER

The certificate loaded by the emqx_ctl license reload command will only take effect during this runtime of EMQX Enterprise. If you need to permanently update the path of the License certificate, you still need to replace the old certificate or modify the configuration file.