The Aquarium meets the Smart Home!
View on GitHub | Join the conversation on Reef2Reef!

Setup Guide
Build It Yourself

AquaPi for ESPHome is a project that helps you build a powerful aquarium monitoring and automation system using affordable ESPHome devices and Home Assistant. Make endless automations and monitor temperature, water level, and upgrade for advanced aquarium monitoring: pH, salinity, dissolved oxygen, and more (using EZO circuits and probes).

Why use AquaPi?

  • Open-source: Freely available for anyone to access, modify, and contribute to.
  • Modular: Designed to be easily expanded and customized based on your specific needs.
  • Modernized: Utilizes the latest technologies and tools for a seamless user experience.
  • Customizable: Adapt the system to fit your unique aquarium setup and monitoring preferences.
  • Versatile: Expand the system’s capabilities with your own compatible sensors and equipment.
  • Affordable: Offers a cost-effective alternative to many high-end monitoring solutions.
  • Powerful: Provides comprehensive monitoring capabilities for various water parameters.

Buy Now!

PXL_20230529_200205979

Install

You can typically skip this as AquaPi comes pre-installed!
Use the button below to install the pre-built firmware directly to your device via USB from the browser.

Hardware Used

ESP32 devkit
HomeAssistant using a Raspberry Pi 3 or above. The more RAM, the better.

Sensors:
Temperature

  • DS18B20 Waterproof Thermistor

Water Level

  • Food Grade Optical Infrared Water Liquid Level Sensor

Water Leak Sensor

  • Liquid Detection Sensor, 6ft Cable, 2 Mounting Screws w/Magnetic Mount

pH: Atlas Scientific pH: EZO-pH & Lab Grade pH Probe

  • EZO™ pH Circuit, ISO 10523 Compliant
  • Double junction silver / silver chloride Lab Grade pH Probe with Vanadium III, Gen 3
  • Electrically Isolated EZO™ Carrier Board
  • Range: 0 - 14
  • Time Before Recalibration: 1 Year
  • Life Expectancy: ~2.5+ Years

Salinity: Atlas Scientific Conductivity: EZO-EC & Conductivity Probe K 1.0

  • EZO™ EC Circuit, ISO 7888 Compliant
  • Conductivity Probe K 1.0, Graphite, Gen 3
  • Electrically Isolated EZO™ Carrier Board
  • Range: 0.07 − 500,000+ μS/cm
  • Time Before Recalibration: ~10 Years
  • Life Expectancy: ~10 Years

Dissolved Oxygen: Atlas Scientific DO: EZO-DO & Dissolved Oxygen Probe

  • EZO™ DO Embedded Circuit
  • Range: 0.00 - 100 mg/L (0 - 350% saturation)
  • Life Expectancy: ~4 Years

ORP: Atlas Scientific ORP: EZO-ORP & ORP Probe

  • EZO™ ORP Embedded Circuit
  • Range: -2000mV - 2000 mV
  • Life Expectancy: ~2 Years

Peristaltic Dosing Pump: Atlas Scientific Pump: EZO-PMP

  • EZO™ Pump Embedded Circuit
  • Flow Rate: 0.5ml to 105ml/mins
  • Tube Size: 5mm
  • Head Height: 8.1m(26.5’)

Carbon Dioxide - Gaseous: Atlas Scientific CO2: EZO-CO2

  • EZO™ CO2 Embedded Circuit, Gaseous
  • Range: 0 − 10,000 ppm
  • Life Expectancy: ~5.5 Years

Other EZO probes that should work but not yet tested:
Humidity, Temperture

Prerequisite!! A Raspberry Pi (or something similar) running HomeAssistant to communicate and interact with the ESP32 via homeassistant.local:8123. Get Raspberry Pi Imager

Software Used

Home Assistant: Open source home automation that puts local control and privacy first.
ESPHome: A system to control your ESP8266/ESP32 and RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.

made-for-esphome-white-on-black

HomeAssistant
ESPHome
EZO-pH Circuit Datasheet
EZO-EC Circuit Datasheet
EZO-PMP Circuit Datasheet
EZO-CO2 Circuit Datasheet