Development / Build

Install build tools (rust and rustup)

Linux / Raspberry Pi / MacOS

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Windows

Please follow the instructions for Installing rustup on Windows

Install nightly toolchain

Once you have rustup up and running, please install the nightly toolchain.

rustup update nightly

Clone the repository

git clone https://github.com/reactive-graph/reactive-graph.git

Build the application

Build in development mode:

cd reactive-graph
cargo build

Build in release mode (takes longer, smaller binaries):

cd reactive-graph
cargo build --release

Run the application

cargo run

or:

cargo run --release

Checkout new version and rebuild

1. Fetch the latest version from git:

   git pull
   

2. (Optional) If you want a completely clean build

   cargo clean
   

3. Update dependencies

   cargo update
   

4. Build the application

   cargo build
   

5. Repeat this for all plugins

Build plugins

Checkout and build the plugin

cd ..
git clone https://github.com/reactive-graph/plugin-mqtt.git
cd plugin-mqtt

Build in development mode:

cargo build

Build in release mode:

cargo build --release

Configure plugin

Edit config/plugins.toml and add a section for the plugin. The name must match the crate name of the plugin. Specify the path to the dynamically linked library. The path can be either absolute or relative to the working directory of the application.

[[plugin]]
name = "plugin-mqtt"
active = true
path = "../plugin-mqtt/target/debug/libreactive-graph_plugin_mqtt.so"

Plugin Compatibility

17:18:18.642 [ERROR] [main] Cannot load plugin path/libreactive_graph_plugin_base.so because of a compiler version mismatch: rustc 1.81.0 (expected: 1.82.0)