# Airlock

{% hint style="warning" %}
Plaato has been discontinued. The original Plaato app and cloud workflow is no longer the recommended setup path.

For Brewfather, the working replacement is to connect the device to an [`open-plaato-keg`](https://github.com/DarkJaeger/open-plaato-keg) server first, then forward that Airlock to Brewfather from the server UI.
{% endhint %}

## Quick guide

1. Start an `open-plaato-keg` server and note its local IP address. See the [`open-plaato-keg` setup and deployment docs](https://github.com/DarkJaeger/open-plaato-keg#setup) and the full steps in [1. Start the open-plaato-keg server](#1-start-the-open-plaato-keg-server).
2. Connect to the Airlock Wi-Fi network `PLAATO-XXXXX`, open `http://192.168.4.1`, and save your Wi-Fi, Auth Token, server host, and port `1234`. See the [`PLAATO Airlock Setup Guide`](https://raw.githubusercontent.com/DarkJaeger/open-plaato-keg/master/User%20Guides/PLAATO_Airlock_Setup_Guide.pdf) and the full steps in [2. Connect the Airlock to open-plaato-keg](#2-connect-the-airlock-to-open-plaato-keg).
3. In Brewfather, enable **Settings > Power-ups > Plaato Airlock** and copy the **Logging URL**. See [Settings](https://docs.brewfather.app/settings) and the full steps in [3. Enable Plaato Airlock in Brewfather](#3-enable-plaato-airlock-in-brewfather).
4. In `open-plaato-keg`, open **Configure > Airlock Setup**, select the Airlock, paste the Brewfather Logging URL, and save the Brewfather settings. See the [`PLAATO Airlock Brewfather Integration Guide`](https://raw.githubusercontent.com/DarkJaeger/open-plaato-keg/master/User%20Guides/PLAATO_AirLock_Brewfather_Setup_Guide.pdf) and the full steps in [4. Link the server to Brewfather](#4-link-the-server-to-brewfather).
5. Wait for the Airlock to appear on the [Devices](https://docs.brewfather.app/devices) page, then attach it to your batch from **Fermenting > Readings > Devices**. See the full steps in [5. Verify the device in Brewfather](#5-verify-the-device-in-brewfather).

## External references

* [`open-plaato-keg` GitHub repo](https://github.com/DarkJaeger/open-plaato-keg)
* [`open-plaato-keg` User Guides](https://github.com/DarkJaeger/open-plaato-keg/tree/master/User%20Guides)
* [`PLAATO Airlock Setup Guide`](https://raw.githubusercontent.com/DarkJaeger/open-plaato-keg/master/User%20Guides/PLAATO_Airlock_Setup_Guide.pdf)
* [`PLAATO Airlock Brewfather Integration Guide`](https://raw.githubusercontent.com/DarkJaeger/open-plaato-keg/master/User%20Guides/PLAATO_AirLock_Brewfather_Setup_Guide.pdf)

## Before you start

* A working **Plaato Airlock**
* A **2.4 GHz Wi-Fi** network
* A device on your local network running `open-plaato-keg`, such as a Raspberry Pi, Docker host, or home server
* Access to the **Plaato Airlock** power-up in Brewfather
* An active batch in **Fermenting** when you are ready to attach the device

## 1. Start the open-plaato-keg server

Set up and start the server by following the upstream project documentation:

* [`open-plaato-keg` README](https://github.com/DarkJaeger/open-plaato-keg)
* [Setup](https://github.com/DarkJaeger/open-plaato-keg#setup)
* [Deployment](https://github.com/DarkJaeger/open-plaato-keg#deployment)

Quick example:

```bash
docker run --rm -it -p 1234:1234 -p 8085:8085 ghcr.io/darkjaeger/open-plaato-keg:latest
```

After the server starts:

1. Note the server IP address on your local network.
2. Make sure the Airlock can reach the server on port `1234`.
3. Open `http://<server-ip>:8085` to confirm the web UI is reachable.

## 2. Connect the Airlock to open-plaato-keg

Follow the upstream [`PLAATO Airlock Setup Guide`](https://raw.githubusercontent.com/DarkJaeger/open-plaato-keg/master/User%20Guides/PLAATO_Airlock_Setup_Guide.pdf) for the original Airlock onboarding flow. The summary below matches that guide.

1. Power on the Plaato Airlock.
2. On first boot or after reset, it creates a temporary Wi-Fi network named `PLAATO-XXXXX`.
3. Connect your phone, tablet, or computer to that Wi-Fi network.
4. Ignore any "no internet" warning and stay connected.
5. Open `http://192.168.4.1` in a browser.
6. Enter the Airlock configuration values:
   * **WiFi SSID**: your 2.4 GHz home network name
   * **WiFi Password**: your network password
   * **Auth Token**: a unique 32-character hexadecimal value
   * **Host**: the IP address of your `open-plaato-keg` server
   * **Port**: `1234`, or your configured `KEG_LISTENER_PORT`
7. Save the configuration and let the Airlock reboot.
8. Open `http://<server-ip>:8085`, go to **Configure > Airlock Setup**, select the Airlock, and give it a unique name.
9. Confirm the Airlock appears on the server dashboard and starts reporting data.

{% hint style="info" %}
If you are using more than one Airlock, each device needs its own unique **Auth Token** and its own descriptive name on the server.
{% endhint %}

## 3. Enable Plaato Airlock in Brewfather

This is the Brewfather side of the setup. See [Settings](https://docs.brewfather.app/settings) for the Power-ups page overview.

1. In Brewfather, open **Settings > Power-ups > Plaato Airlock**.
2. Enable the integration.
3. Copy the **Logging URL** shown by Brewfather.

{% hint style="info" %}
The upstream `open-plaato-keg` guide may refer to **Settings > Integrations**. In Brewfather docs and current UI, this setup lives under **Settings > Power-ups**.
{% endhint %}

## 4. Link the server to Brewfather

Follow the upstream [`PLAATO Airlock Brewfather Integration Guide`](https://raw.githubusercontent.com/DarkJaeger/open-plaato-keg/master/User%20Guides/PLAATO_AirLock_Brewfather_Setup_Guide.pdf) for the server-to-Brewfather forwarding flow. The steps below summarize that process in Brewfather terms.

1. Open the `open-plaato-keg` web UI at `http://<server-ip>:8085`.
2. Go to **Configure > Airlock Setup**.
3. Select the Airlock you want to send to Brewfather.
4. In the Brewfather section, enter:
   * **Brewfather URL**: paste the Logging URL from Brewfather
   * **Temp Units**: match your Brewfather batch temperature unit
   * **Starting SG / Specific Gravity**: the batch starting gravity or current specific gravity
   * **Original Gravity**: optional
   * **Batch Volume**: optional
5. Save the Brewfather settings.

The server forwards readings to Brewfather at most once every **15 minutes** per Airlock.

## 5. Verify the device in Brewfather

See [Devices](https://docs.brewfather.app/devices) for how discovered devices appear and how batch attachment works.

1. Wait up to **15 minutes** for the first forwarded reading.
2. Open the [Devices](https://docs.brewfather.app/devices) page in Brewfather and confirm the Plaato Airlock appears there.
3. Open the active batch you want to track.
4. In the **Fermenting** tab, open **Readings > Devices**.
5. Attach the Plaato Airlock to the batch.
6. Wait for the next logging interval for readings to appear in the batch.

{% hint style="info" %}
Brewfather ignores device updates that arrive more often than once every 15 minutes per device. The BPM graph may take around **one hour** to populate because it needs multiple readings.
{% endhint %}

## Data logged

With this setup, Brewfather receives:

* **Temperature**
* **BPM**
* **Specific gravity**
* **Original gravity** if you configured it on the server
* **Batch volume** if you configured it on the server

## Troubleshooting

* **The Airlock does not show `PLAATO-XXXXX`**

  Power-cycle or reset the Airlock, then follow the upstream [`PLAATO Airlock Setup Guide`](https://raw.githubusercontent.com/DarkJaeger/open-plaato-keg/master/User%20Guides/PLAATO_Airlock_Setup_Guide.pdf) again.
* **`http://192.168.4.1` does not open**

  Confirm your phone or computer is still connected to the Airlock Wi-Fi network, not your normal home network.
* **The Airlock does not appear on the open-plaato-keg server**

  Verify the Wi-Fi is 2.4 GHz, the server IP address is correct, and the port matches `KEG_LISTENER_PORT`.
* **The Airlock appears on the server but not in Brewfather**

  Re-copy the Brewfather Logging URL, save the Brewfather section again in `open-plaato-keg`, then wait for the next 15-minute interval. If needed, recheck the upstream [`PLAATO Airlock Brewfather Integration Guide`](https://raw.githubusercontent.com/DarkJaeger/open-plaato-keg/master/User%20Guides/PLAATO_AirLock_Brewfather_Setup_Guide.pdf).
* **The device appears in Brewfather but not in the batch**

  Attach it from **Fermenting > Readings > Devices**. Readings are not logged to a batch until the device is attached.

## Related docs

* [Plaato Keg](https://docs.brewfather.app/integrations/plaato/keg)
* [Plaato](https://docs.brewfather.app/integrations/plaato)
* [Devices](https://docs.brewfather.app/devices)
* [Settings](https://docs.brewfather.app/settings)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.brewfather.app/integrations/plaato/airlock.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.