vernemq v0.1.0

Messaging

VerneMQ — a high-performance, distributed MQTT message broker (Erlang/OTP) for IoT and messaging at scale, with a built-in HTTP status/metrics endpoint. Deployed as a single host-networked Nomad service.

nomad-pack run vernemq --registry nomploy

…or one line (add registry + run)

curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- vernemq

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 3.6k ⚑ Report an issue

1 task mqtt 1883http 8888 image vernemq/vernemq:latest tracks :latest image bumped today

Variables 10

values.hcl

Save as values.hcl, edit, then run:

nomad-pack run vernemq -f values.hcl --registry nomploy

# The name of the Nomad job.
job_name = "vernemq"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The VerneMQ container image. Pin a tag in production.
image = "vernemq/vernemq:latest"

# Host port for MQTT.
mqtt_port = 1883

# Host port for the HTTP status page / metrics / health.
http_port = 8888

# Allow anonymous MQTT clients (on/off). Turn off and configure auth for production.
allow_anonymous = "on"

# Named volume for VerneMQ message store / metadata (/vernemq/data).
data_volume = "vernemq_data"

# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# The task resources.
resources = {
    cpu    = 500
    memory = 512
  }

Name	Type	Default	Description
job_name	string	"vernemq"	The name of the Nomad job.
namespace	string	"default"	The Nomad namespace to deploy into.
datacenters	list	["*"]	The datacenters to deploy to.
image	string	"vernemq/vernemq:latest"	The VerneMQ container image. Pin a tag in production.
mqtt_port	number	1883	Host port for MQTT.
http_port	number	8888	Host port for the HTTP status page / metrics / health.
allow_anonymous	string	"on"	Allow anonymous MQTT clients (on/off). Turn off and configure auth for production.
data_volume	string	"vernemq_data"	Named volume for VerneMQ message store / metadata (/vernemq/data).
constraints	list	[]	Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources	object	{ cpu = 500 memory = 512 }	The task resources.

Readme

vernemq

VerneMQ is a high-performance, distributed MQTT broker built on Erlang/OTP. It's designed to scale to very large numbers of concurrent IoT/messaging clients, supports MQTT 3.1/3.1.1/5.0, shared subscriptions, QoS 0–2, clustering, and exposes a built-in HTTP endpoint for status, health and Prometheus metrics.

This pack runs a single VerneMQ node as a host-networked Nomad service.

Deploy

nomad-pack run vernemq --registry=nomploy

Point MQTT clients at <node-ip>:1883; see broker status at http://<node-ip>:8888/status.

Configuration

Variable	Default	Description
`image`	`vernemq/vernemq:latest`	Container image (pin a tag in production).
`mqtt_port`	`1883`	MQTT listener.
`http_port`	`8888`	HTTP status / health / metrics.
`allow_anonymous`	`on`	Allow anonymous clients (set `off` for prod).
`data_volume`	`vernemq_data`	Volume for the message store (`/vernemq/data`).
`resources`	500 MHz / 512 MB	CPU and memory for the task.

Security: anonymous access is enabled for a frictionless start. Before exposing the broker, set allow_anonymous=off and configure authentication (VerneMQ password file or an auth plugin) via the DOCKER_VERNEMQ_* env vars.