EbbFlowManager

Web application to show the status and manage the configuration of multiple Ebb Flow Controller. For an automated Ebb Flow Hydroponic ecosystem.

System Overview

The System consists of 5 Components

• Ebb Flow Manager
• Ebb Flow Controller
• MQTT Broker
• MQTT2DB
• Mongo DB Database

Each Ebb Flow Controller is connected to one hardware rack and controls it independently. For configuration, status and data logging the Ebb Flow Controller has a MQTT connection. All the data from the Ebb Flow Controller is written with the MQTT2DB application to a Mongo DB database. The Ebb Flow Manager reads the data from this Database to show the data of the Controller and can send new configurations to the Controller by publishing MQTT Messages.

graph TD
GrowRack_1([Ebb Flow Rack 1])
GrowRack_2([Ebb Flow Rack 2])
GrowRack_3([Ebb Flow Rack 3])
GrowRack_...([Ebb Flow Rack ...])
GrowController_1(Ebb Flow Controller 1)
GrowController_2(Ebb Flow Controller 2)
GrowController_3(Ebb Flow Controller 3)
GrowController_...(Ebb Flow Controller ...)
MQTTBroker(MQTT Broker)
MQTT2DB(MQTT2DB)
DB[(Database)]
Configurator(Ebb Flow Manager)


GrowRack_1 <--> GrowController_1;
GrowRack_2 <--> GrowController_2;
GrowRack_3 <--> GrowController_3;
GrowRack_... <--> GrowController_...;
GrowController_1 <--> MQTTBroker;
GrowController_2 <--> MQTTBroker;
GrowController_3 <--> MQTTBroker;
GrowController_... <--> MQTTBroker;
MQTTBroker --> MQTT2DB;
MQTT2DB --> DB;
Configurator --> MQTTBroker
DB --> Configurator

Loading

Usage

See the example on how to run all the needed components to use the Ebb Flow Manager.

For more in detail explanation of the configuration see the documentation of the Ebb Flow Controller

Deployment

Local installation

Install and run the application locally using pip.

python3.13 -m venv ./venv/
source venv/bin/activate
pip install . # or use pip install -e .[dev] for development
ebb_flow_manager

For development run

panel serve src/ebb_flow_manager/ebb_flow_manager_app.py --dev

Docker

Checkout the example for using this app with docker compose here.

Or only run the app in a container with the following command.

docker run -d -v ./config.yml:/home/app/config.yml ghcr.io/phofmeier/ebbflowmanager:latest