Configuring MudPi

MudPi loads everything it needs from a JSON formatted file in the root installation folder named mudpi.config. This file can be manually created or you can use this bonus configuration tool to create your file to make your life easier.

Here is the barebone structure of the configuration file. MudPi will only load components and services found in this configuration file on boot. There should not be empty or null values in this config file. Instead the option should be omitted if it is not used.

    "name": "MudPi",
    "debug": false

You can see there are two sections to the minimal configuration file. Currently name and debug are the only required options.

MudPi includes an example configuration file to get you started. You can find this file in the installation root named mudpi.config.example. You should use this as a reference when creating your own config file.

General Settings

name[String]YesName of the system. Mainly here for labeling the system and to pull for a UI.
debug[Boolean]YesIf enabled, MudPi will output more information while the system runs. More information about the startup sequence and each of the cycles will be output.
redis[Object]NoA configuration object for redis. Contains a host and port. Read more on Redis.
workers[Array]NoArary of configuration objects for Workers. Read more on workers.
triggers[Array]NoArary of configuration objects for Triggers. Read more on triggers.
actions[Array]NoArary of configuration objects for Actions. Read more on triggers.
sequences[Array]NoArary of configuration objects for Automation Sequences. Read more on automation sequences.
logger[Object]NoConfiguration object for Logger. Read more about the logger. and the data MudPi logs for you.
camera[Object]NoConfiguration object for Camera. Read more on the camera.
nodes[Array]NoArary of configuration objects for Nodes. Read more on nodes.

Basic Test Configuration

Try booting with only the required options in order to see if all the dependencies have been installed and if MudPi will successfully run. Below is an example of the minimum configuration options needed to test the system.

    "name": "MudPi",
    "debug": false,
    "redis": {
        "host": "",
        "port": 6379


If your having trouble getting your configuration file to load make sure to look closely at your value types (i.e. "10" is not the same as 10). Make sure there are no empty settings values, option settings should be removed rather than left empty/null. Check all your quotes, colons, commas, brackets, parenthesis and capitalization.