Setup AquaPi - TheRealFalseReality/aquapi GitHub Wiki
Welcome to the AquaPi setup guide! Follow these steps to connect your AquaPi hardware and get started with Home Assistant or the built-in Web Server.
Note
All sensors and their respective connectors are color-coded for ease of installation:
- Green: Dallas Temperature Probe(s) (support for 2+ probes with an additional Y-cable).
- Blue/Yellow: Optical Sensors (connected via the supplied Y-cable).
- Red: All I2C sensors, including EZO sensors (connect multiple sensors using additional Y-cables).
- White: Water Leak Sensor & Optional sensors, such as extra optical sensors or DAC pins (reserved for future use).
Warning
The AquaPi will not boot if the Binary 2 sensor is ON. If this occurs, physically remove the sensor, boot the AquaPi, then reconnect the sensor. This applies only when adding your own custom sensors.
-
Install and Power On Home Assistant:
- Download and install the latest version of Home Assistant.
- Connect Home Assistant to your network using an Ethernet cable and power it on.
-
Access Home Assistant in Your Browser:
- Open your preferred web browser.
- Navigate to:
http://homeassistant.local:8123
-
Complete Home Assistant Onboarding:
- Follow the Home Assistant Onboarding Instructions to set up your instance.
- Use the images below for references during onboarding.
-
Power on the AquaPi:
- Plug in the AquaPi. Use your mobile phone to connect to the WiFi network named
aquapi-XXXXXX(whereXXXXXXmatches your device name).
- Plug in the AquaPi. Use your mobile phone to connect to the WiFi network named
-
Join Your Home WiFi Network:
- Select your home WiFi network, enter the WiFi password, and connect.
 |
 |
|---|
-
Discover AquaPi in Home Assistant:
- In Home Assistant, you should see a New Device Discovered notification. Alternatively, go to Settings > Devices & Services to find your device.
- Click
Configurefor the device namedAquaPi XXXXXX(matching the WiFi name) and follow the prompts to add it to Home Assistant. - Once connected, the Blue LED on AquaPi will stop flashing.
 |
 |
|---|
-
Install ESPHome in Home Assistant:
- Navigate to the Add-On Store section in Home Assistant.
- Find and install the ESPHome Add-On.
- Once installed, click Open Web UI to launch the ESPHome dashboard.
 |
 |
|---|
-
Adopt AquaPi in ESPHome:
- In the ESPHome dashboard, locate your AquaPi device. It should appear with a green
Adoptbutton. - Click Adopt, follow the prompts to complete setup.
- Enter your WiFi credentials when prompted, then select
Install>Wirelesslyto update the firmware.
- In the ESPHome dashboard, locate your AquaPi device. It should appear with a green
 |
 |
|---|
- Open the ESPHome dashboard, click on the 3-dots menu for your AquaPi device, and select
Install. - This will download and install the latest firmware while preserving any custom configurations made to the YAML configuration file.
- Update directly from the Home Assistant UI via the
Update Firmwarebutton on the AquaPi integration page. Home Assistant will notify you when a new update is available.
Important
Updating via Home Assistant resets the device to factory defaults. You may need to re-provision your Wi-Fi and reconfigure the device after the update.
 |
 |
|---|
As an alternative to Home Assistant, you can access the AquaPi Web Server:
- After connecting AquaPi to WiFi, open a browser and navigate to:
Replace
http://<hostname>.local/<hostname>with the name of your AquaPi device (e.g.,aquapi-6734b0.local/).
Let me know if you’d like further edits or additions! This updated version improves consistency, clarifies key steps, and maintains a user-friendly tone while integrating your previously provided content and screenshots efficiently.