12

Installation

wuming123057 edited this page 2015-08-31 15:53:19 +08:00

Table of Contents

• Overview
• Download
• Startup
• Status
• Stop
• Build
• Windows
• Install
• Console
• Install
• Start
• Stop
• Uninstall

Overview

emqttd is cross-platform, could run on windows, linux, freebsd and mac os x.

emqttd is easy to install and takes on about 5 minutes to download and startup.

Download

Download binary packages from http://emqtt.io/downloads.

And then:

unzip emqttd-platform-0.x.y-beta.zip && cd emqttd

Startup

Start with console for debug:

# start console
./bin/emqttd console

You could see all RECV/SENT MQTT Packages printed on console.

Start as daemon:

# start daemon
./bin/emqttd start

emqttd will occupy 1883 port for MQTT, 8883 port for MQTT(SSL), 8083 for WebSocket/HTTP.

Status

# check status
./bin/emqttd_ctl status

Stop

# stop
./bin/emqttd stop

Build

emqttd requires Erlang R17+ to build from source.

Erlang R17+ and git client should be installed before building emqttd.

Then:

git clone https://github.com/emqtt/emqttd.git

cd emqttd

git submodule update --init --recursive

make && make dist

Windows

Install

Download windows package from http://emqtt.io/downloads. And then unzip to install folder.

Console

Start console to check if emqttd works.

.\bin\emqttd console

Notice: execute '.\bin\emqttd', should not cd to 'bin' folder.

A window console will show if success.

Install

Register emqttd service:

.\bin\emqttd install

Start

Notice: should close the console window if opened.

Start emqttd service:

.\bin\emqttd start

Stop

Stop emqttd service

.\bin\emqttd stop

Uninstall

Uninstall emqttd service

.\bin\emqttd uninstall

Version: 1.0(Draft) Author: Feng Lee feng@emqx.io