Skip to content

MQTT Web Frontend: Publish, Subscribe and see Topic Status in a comfortable UI

License

Notifications You must be signed in to change notification settings

dersimn/mqtt-admin

 
 

Repository files navigation

This is a fork from https://github.com/hobbyquaker/mqtt-admin used to generate Docker Images. See original documentation for reference about the script itself.

Supported tags

Images for Raspberry Pi are available with the suffix -armhf. E.g.: 1.0.0 -> 1.0.0-armhf.

Config

This image can proxy-pass the Websocket connection from your MQTT broker, by setting the env variable MQTT_HOST.
You have to enable Websockets on your broker. The Docker Image toke/mosquitto for e.g. has it already enabled by default on port 9001, where the official Docker Image eclipse-mosquitto need to be configured first.

docker run -d --restart=always \
    -e "MQTT_HOST=10.1.1.50:9001" \
    -p 80:80 \
    dersimn/mqtt-admin

If you provide an SSL key/cert pair in /ssl, the Docker Image will also enable HTTPS:

  • /ssl/nginx.key
  • /ssl/nginx.crt

Additionally you can enable client-authentification via SSL certificates, by providing:

  • /ssl/client.crt

In case you have revoked clients, also prodive a /ssl/client.crl file.

A nice tutorial on how to generate your own certificates, is located here.

docker run -d --restart=always \
    -v $(pwd)/ssl:/ssl:ro \
    -e "MQTT_HOST=10.1.1.50:9001" \
    -p 80:80 \
    -p 443:443 \
    dersimn/mqtt-admin

If you want to change the default ports, specify it like this: -p 8001:80 -p 8443:443 -e "HTTPS_REDIRECT_PORT=8443".

HTTPS and client-auth are optional for clients connecting via a local IP, according to these IP ranges. If you make port 80/443 public to the Internet you should definitely enable client-auth.

Development

Basic build:

npm install
grunt
docker build -t dersimn/mqtt-admin .
docker build -t dersimn/mqtt-admin:armhf -f Dockerfile.armhf .
grunt clean

About

MQTT Web Frontend: Publish, Subscribe and see Topic Status in a comfortable UI

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 78.6%
  • HTML 12.0%
  • Less 7.2%
  • Dockerfile 1.4%
  • Shell 0.8%