7 releases (3 stable)

1.0.2 Mar 3, 2024
1.0.1 Jun 10, 2023
1.0.0 Nov 18, 2022
0.9.0 Jun 27, 2022
0.7.0 Apr 17, 2022

#113 in Command line utilities

Download history 13/week @ 2024-02-14 4/week @ 2024-02-21 104/week @ 2024-02-28 30/week @ 2024-03-06 59/week @ 2024-03-13 15/week @ 2024-03-27 31/week @ 2024-04-03

108 downloads per month

MPL-2.0 license

91KB
2K SLoC

MQTT Vault logo

MQTT Vault

A JSON database controlled via MQTT.

What it Does

MQTT Vault allows you to create virtual IoT devices that retain their state. These virtual devices communicate over MQTT the same way that many physical IoT devices do, allowing you to control them with the same infrastructure.

For details on using the program, please see manpage.md or run man mqtt_vault after installing.

Features

Database

  • Get and set data via MQTT topics
  • Data is stored as individual JSON files
  • Folder structure corresponds to the topic used to set the data

MQTT over TLS

  • Optionally encrypts the broker connection using an SSL certificate
  • Supports separate or combined public/private keys

Database encryption

  • Optionally encrypts the data stored on disk so it can't be accessed without going through MQTT Vault
  • Allows the encryption key to be changed or removed by passing --change-crypt-key
  • Data is encrypted using the chacha20poly1305 crate

Installing

Arch Linux

MQTT Vault is available on the AUR as mqtt_vault or mqtt_vault-bin. You can also download the Arch release and extract the files yourself.

FreeBSD

Download and extract the FreeBSD.tar.gz release.

Windows

Download and extract the Win64.zip release.

Build with cargo

Run cargo install mqtt_vault. Unfortunately, this method does not install the manpage, but you can always grab it from the repo.

Dependencies

~18–28MB
~467K SLoC