Skip to content

Home

AoT Environmental Monitoring and Control System~

AoT is open source software for monitoring an environment with sensors and controlling devices remotely — not tied to any particular purpose or kind of site. It is built around a GIS digital twin — every device, sensor, and structure has a real place on a map — and an AI layer built on MCP (Model Context Protocol) that can read that map, diagnose it, and act on it with your approval.

It runs natively on the Raspberry Pi and other single-board computers (SBCs), and in Docker on ordinary servers and PCs.

Information~

See About for what AoT does and how the pieces fit together, or the README for features, screenshots, and other information.

Prerequisites~

  • Single-board computer (Recommended: Raspberry Pi, any version: Zero, 1, 2, 3, or 4)
  • Debian-based operating system
  • An active internet connection

Alternatively, AoT can run in Docker on any Linux, macOS, or Windows machine — see Install with Docker below.

Install~

Once booted and logged in, run the following command to initiate the AoT install:

curl -L https://aot-inc.github.io/AoT/install | bash

After installation, open a web browser to the SBC's IP address and you will be prompted to create an Admin user and login.

https://127.0.0.1

Install with Docker~

Prerequisites: Docker with Compose v2. Official images are published for linux/amd64 and linux/arm64.

The compose file mounts the custom extension directories from the repository (aot/inputs/custom_inputs and friends), so clone it first:

git clone https://github.com/AoT-inc/AoT.git /opt/AoT
cd /opt/AoT
cp docker/.env.prod.example docker/.env

Review these values in docker/.env:

  • AOT_IMAGE_TAG — the version to install. Pinning an exact release is recommended.
  • AOT_PORT — host port for the web interface (default 8084).
  • TZ — container timezone (default Asia/Seoul). Data is stored in UTC; this affects log display and local-time scheduling.
  • HARDWARE_PROFILE — LOW (Raspberry Pi, small VM) or HIGH.

Start the stack:

docker compose -f docker/docker-compose.prod.yml up -d

Then open a web browser to the host's IP address on that port, and you will be prompted to create an Admin user and login.

http://127.0.0.1:8084

Upgrading a Docker deployment means pulling a new image and recreating the containers, not replacing files on disk. See Upgrade/Backup/Restore.

Note

The Docker stack does not pass the host's GPIO, I2C, or 1-Wire devices into the containers. Use the direct install for sensors and relays wired to Raspberry Pi pins. Network-attached devices — LoRaWAN (ChirpStack), Modbus TCP, MQTT — work the same in either installation.

Support~