Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gbour/wave
MQTT Broker - for IoT, DIY, pubsub applications and more
https://github.com/gbour/wave
broker erlang iot message-queue mqtt mqtt-broker ssl websockets
Last synced: about 2 months ago
JSON representation
MQTT Broker - for IoT, DIY, pubsub applications and more
- Host: GitHub
- URL: https://github.com/gbour/wave
- Owner: gbour
- License: agpl-3.0
- Created: 2014-11-16T15:20:09.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2017-04-20T20:43:32.000Z (over 7 years ago)
- Last Synced: 2024-10-13T23:26:36.662Z (2 months ago)
- Topics: broker, erlang, iot, message-queue, mqtt, mqtt-broker, ssl, websockets
- Language: Erlang
- Homepage:
- Size: 3.1 MB
- Stars: 26
- Watchers: 4
- Forks: 1
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
wave [](http://travis-ci.org/gbour/wave) 
====
Wave is a MQTT Broker, written in Erlang.
It implements most of MQTT features, and currently supports TCP and SSL transports (and soon WebSockets)
You can try it on **[iot.bour.cc](http://iot.bour.cc)**.
A Docker image is also available on **[Docker hub](https://hub.docker.com/r/gbour/wave)**.
Features
--------
* [x] MQTT v1.3
* [x] MQTT v1.3.1
* [x] Qos 0, 1 & 2
* [x] SSL
* [x] WebSockets
* [x] $SYS hierarchy
* [x] monitoring
* [x] access logs
* [x] authentication
* [ ] ACLs
* [ ] administration interface
* [ ] plugins
Quickstart
----------
### Checkout, build & run
prerequisites:
* redis
* erlang >= 17.2
```
$> git clone https://github.com/gbour/wave.git wave
$> cd wave && make
# 'make cert' generates sample self-signed certificate, required to start wave with default configuration
# you can alternatively provide your own
$> make cert
$> make run
```
NOTE: the build process is also generating a default self-signed certificate that you can replace later
### Docker image
Alternatively, you can use docker image available on Docker hub (along with official redis image):
```
$> docker pull redis:alpine
$> docker run --name redis-wave -d redis:alpine
$> docker pull gbour/wave:websockets
$> docker run --name wave -d --link=redis-wave -p 1883:1883 -p 8883:8883 gbour/wave:websockets
```
### Give it a try
Now, you can try using ie mosquitto tools:
```
$> mosquitto_sub -h localhost -t foo/bar -v&
$> mosquitto_pub -h localhost -t foo/bar -m 'is it working?'
foo/bar is it working
```
Authors
-------
Main developer: Guillaume Bour <[email protected]>
License
-------
**Wave** is distributed under AGPLv3 license.