dersimn/mqtt-admin repository overview

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

• 1.2.0, latest⁠
• 1.1.0⁠
• 1.0.0, hobbyquaker-untouched⁠

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.