
The Aquarium meets the Smart Home! AquaPi brings powerful monitoring and automation to your aquarium setup using affordable ESPHome devices and Home Assistant.
Open-source: Freely accessible for anyone to use, modify, and contribute.
Modular and Customizable: Expand the system to fit your specific needs and preferences.
Affordable: A budget-friendly alternative to high-end monitoring solutions without compromising functionality.
Versatile: Monitor and automate a wide range of vital water parameters such as pH, salinity, dissolved oxygen, and more.
Quick Links
- Setup Guide: Start here for step-by-step instructions.
- Build It Yourself: Parts list and assembly guide.
- In-Depth Wiki: Calibration, sensor info, circuit diagrams, and more.
- Join the Discussion! Participate in the Reef2Reef forums!
- Buy AquaPi Now! Purchase complete builds or modular components.
Why AquaPi?
Demo
|
|
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.
Key Features
- Comprehensive monitoring for temperature, pH, salinity, dissolved oxygen, and more using affordable Atlas Scientific EZO circuits.
- Seamless integration with ESPHome and Home Assistant for robust automation, visualization, and control.
- Expandable system to add new sensors, actuators, and custom automations tailored to your aquarium.
Hardware Requirements
- ESP32 DevKit: A versatile microcontroller to power AquaPi.
- Home Assistant Device: A Raspberry Pi 3 or higher is recommended (the more RAM, the better).
- Setup Home Assistant on your Raspberry Pi: Get Raspberry Pi Imager
- Power Supply: A reliable 5V 3A power source.
Supported Sensors and Probes
Temperature (Dallas DS18B20):
- Waterproof thermistor capable of supporting multiple probes using an index-based configuration.
- Temperature Sensor Wiki
Water Level:
- Optical infrared liquid sensors with magnetic mounts.
Water Leak Sensor:
- Detects leaks with liquid detection sensors and magnetic mounting for flexibility.
pH Monitoring (EZO-pH):
- High-accuracy pH measurements with the EZO pH circuit, ISO 10523 compliant.
- Range: 0-14 pH
- Recalibration Interval: 1 year
- Probe Life Expectancy: ~2.5+ years
- pH Datasheet
Salinity Conductivity (EZO-EC):
- Measures conductivity, TDS, salinity, and specific gravity with EZO EC circuit, ISO 7888 compliant.
- Range: 0.07−500,000+ μS/cm
- Recalibration Interval: ~10 years
- Probe Life Expectancy: ~10 years
- EC Datasheet
Dissolved Oxygen Monitoring (EZO-DO):
- Accurate dissolved oxygen monitoring, suitable for many environments.
- Range: 0.00-100 mg/L (0-350% saturation)
- Probe Life Expectancy: ~4 years
- DO Datasheet
Oxidation-Reduction Potential (EZO-ORP):
- Measures the oxidation or reduction potential state in water.
- Range: -2000mV to +2000mV
- Probe Life Expectancy: ~2 years
- ORP Datasheet
Peristaltic Dosing Pump (EZO-PMP):
- Dispenses liquids accurately for chemical or nutrient dosing.
- Flow Rate: 0.5ml to 105ml/min
- Tube Size: 5mm
- Head Height: 8.1m (26.5’)
- Peristaltic Pump Datasheet
Carbon Dioxide Air Monitoring (EZO-CO2):
- Measures gaseous CO2 concentration.
- Range: 0−10,000 ppm
- Life Expectancy: ~5.5 years
- CO2 Datasheet
Additional Supported Sensors
- Humidity: EZO-HUM Datasheet
- RTD Temperature: EZO-RTD Datasheet
Circuit Diagram
For a detailed circuit diagram and wiring instructions, visit the Wiki Circuit Page.
Installation and Setup
Setup Your Devices:
Follow the Setup Guide for detailed step-by-step instructions for configuring your ESP32, connecting your sensors, and running AquaPi.
Update Wirelessly:
Keep your AquaPi firmware up-to-date with ESPHome using the built-in Over-the-Air (OTA) update functionality. For details, see the Update Guide.
Web Server Access:
Optionally, you can access AquaPi’s web server for managing the device without Home Assistant. See the Web Server Guide for more details.
Expand and Customize AquaPi
AquaPi’s modular design can be customized and expanded to meet your specific needs. For advanced configurations, see:
- Blueprints: Automations to control other smart devices in Home Assistant.
- Substitutions: Custom configuration variables for your specific setup.
AquaPi AI: Your Intelligent Aquarium Assistant 🐠
AquaPi AI: Level up your aquarium with AI!
- AI Compatibility Calculator: Check fish compatibility instantly.
- Care Guides & Recommendations: Get expert tank advice.
- Automation Scripts & Photo Analysis: Automate your aquarium and analyze photos for optimized care.
Get Started Today!
- Check out the Setup Guide to start using AquaPi.
- Enhance your aquarium monitoring with AquaPi’s powerful open-source, modular system!