A browser-based dashboard to monitor and automate indoor agriculture using the Raspberry Pi.
PLEASE NOTE: This version of the FruxePi is still under development and in prototype. Our goal is to make this application effortless to deploy and run on your Raspberry Pi. However, until we get all the bugs worked out, this project may require the knowledge of an advanced Pi user. Nonetheless, if you are keen on this project and are having issues deploying FruxePi, please create an issue explaining your problem or contact [email protected].
The FruxePi is a web application running on a LAMP stack (Linux, Apache, MySQL, PHP) which can be accessed from the browser on your local network. The application collects grow data from a variety of sensors and controls various operations such as lighting, ventilation and watering, using relay modules.
Using the browser-based dashboard, users can easily monitor the status of their growing environment and automate certain tasks.
The basic functionalies of the FruxePi include:
The FruxePi runs on the RaspberryPi using several sensors and relays:
The FruxePi has been tested and runs well on the following models running Raspian:
- Raspberry Pi 3 Model B
- Raspberry Pi Model Zero W
The DHT22 is a basic digital temperature and humidity sensor. It uses a capacitive humidity sensor and a thermistor to measure the surrounding air, and spits out a digital signal on the data pin, no analog input pins needed.
The TE215 moisture probe is sensitive to ambient humidity and is used to detect the moisture content of the soil or growing medium. The module outputs a HIGH or LOW value when the the soil humidity exceeds a set threshold value.
5V Relay Modules
5V Relay Modules are a great way to control high current and high voltage devices directly from the Raspberry Pi.
Raspberry Pi Camera
The Raspberry Pi Camera Module is the official camera product from the Raspberry Pi Foundation. The FruxePi has been tested using the 8MP Camera Module v2 (2016).
Please see the full list of requirements and further information regarding each component.
Quickly deploy the FruxePi application using Docker and the installation script.
Clone the FruxePi repository to your Raspberry Pi or download the ZIP file.
git clone https://github.com/fruxefarms/FruxePi.git cd FruxePi
sudo bash install.sh to quickly install the application as well as Docker, Docker Compose and some other installation dependencies.
Besides the Docker installation, the FruxePi can also be manually installed and configured by following these instructions. Good luck!
Launch the application from your browser and login!
After successful deployment, visit
http://<your-raspi-ip-address>:80/ in your browser to launch the FruxePi dashboard and login with the default credentials below:
User: [email protected]
This project was built with the assistance of the following libraries and tools:
This project is released under GPL 3.0.
You are free to use, copy, distribute and transmit this software for non-commercial purposes.
Read the LICENSE for details in full.
We are a collective of programmers and master growers. Our goal is to develop open-source software and low-cost hardware to automate indoor agriculture.