Documentation / Getting Started

Getting Started

Installation

The release installer downloads the appropriate binary, installs the systemd service and sets up the web UI.

curl -fsSL https://aquadaemon.org/aquachemd/install.sh | sudo bash

For testing the GitHub Pages copy directly:

curl -fsSL https://aquadaemon.github.io/aquachemd/install.sh | sudo bash

Prerequisites

  • Raspberry Pi OS based on Debian 13 (Trixie) or newer.
  • Enable I2C if using EZO sensors: dtparam=i2c_arm=on or use raspi-config.
  • Enable 1-Wire if using Dallas/DS18B20 sensors: dtoverlay=w1-gpio or use raspi-config.
  • Reboot after changing the Raspberry Pi interface configuration.

First configuration

After installation, the daemon serves its web interface. Open the Pi's address in a browser, then use the menu to reach the management page. The project documentation recommends scanning the system first, then adding sensors, interlocks and outputs through the configuration editor.

Installation / management screenshots — image to be added

Service troubleshooting

sudo systemctl status aquachemd sudo systemctl stop aquachemd sudo systemctl start aquachemd

The configuration file is normally /etc/aquachemd.conf. To run the daemon manually while diagnosing errors:

sudo /usr/local/bin/aquachemd -c /etc/aquachemd.conf

Command-line modes

aquachemd -h aquachemd -c <file> aquachemd -v aquachemd scan aquachemd deepscan aquachemd calibrate aquachemd calibrate ph <low|mid|high> aquachemd calibrate orp <mv_value> aquachemd calibrate rtd <°C_value> aquachemd calibrate prs <psi_value>