From d6cf9f612c472d054632ef2937bc40da455be03b Mon Sep 17 00:00:00 2001 From: mburakov Date: Mon, 1 Nov 2021 14:41:42 +0100 Subject: Create README.md --- README.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..28a5c3e --- /dev/null +++ b/README.md @@ -0,0 +1,34 @@ +# MQhTTp + +This is a lightweight lua-scriptable http gateway to mosquitto. + +## Building on Linux + +MQhTTp depends on libmosquitto and luajit. Once you have these installed, just +``` +make +``` + +## Building anywhere else + +I don't care about any other platforms except Linux, so you are on your own. + +## Running + +Provide host and port of your mosquitto server on the commandline, i.e. +``` +./mqhttp localhost 1883 +``` + +After starting, HTTP server listens for incoming connections on localhost, port 8080. +If you are not happy with these defaults, you can change them by adjusting environment variables: +``` +export HTTP_PORT=8080 +export HTTP_ADDR=0.0.0.0 +``` + +During the start up, MQhTTp sources all the lua files in the current directory (if any). + +## Bugs + +Yes. -- cgit v1.2.3