> For the complete documentation index, see [llms.txt](https://docs.brewfather.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brewfather.app/integrations/tilt-hydrometer/tiltbridge-setup.md).

# TiltBridge Setup

TiltBridge is standalone hardware designed to allow your Tilt Hydrometer to connect directly to Wi-Fi without the need for an old cell phone, tablet, or Raspberry Pi. We recommend an ESP32 OLED board with Wi-Fi and Bluetooth. This means you’ll have a small screen on the board where you can also see the information from your Tilt. You will also need a Micro USB charger.

1\. Download and install BrewFlasher from <https://github.com/thorrak/brewflasher/releases>\
(both Windows and macOS)

2\. Connect the TiltBridge board to a USB port on your PC/Mac

3\. Run BrewFlasher and set/select the following (see example of the window below):

* Serial port - where your TiltBridge is located
* Project - TiltBridge
* Device Family - ESP32
* Firmware - TiltBridge BETA - v0.2 - OLED

![](/files/-M9UJzR_tGm-fsttvhkx)

* Erase flash - yes, wipes all data

4\. Click the **Download Firmware and Flash Controller** button.

![](/files/-M9UKB-E6-jv7S6goduR)

5\. When the Console shows «Connecting…..», press the Boot button on the back of your board. This enables the upload to continue.

6\. The upload of the firmware should be done.

7\. Remove the Micro USB plug from the board and re-attach it again.

8\. You will see a message showing this:

![](/files/-M9UKjQ_CKsdeOkobJX5)

## Configuring TiltBridge for Brewfather

You'll first need to connect TiltBridge to your Wi-Fi and then configure it to use the Tilt API key.

1\. Go to Brewfather and copy the API key for Tilt located under Settings. You will need this key soon.

2\. Navigate to <http://tiltbridge.local/> or the IP address shown on the board screen.

3\. Click the Settings link at the top of the dashboard

4\. In the Brewfather Settings section at the bottom of the screen, paste the API key in the field Brewfather Stream key. Make sure you only insert the key itself and not the full URL.

![](/files/-M9UKqJGig-Thjf7g549)

5\. Click the Update button.

6\. You should be good to go. Make sure you place the TiltBridge board close to your Tilt Hydrometer and within the range of your Wi-Fi.

For more details regarding TiltBridge, please see <https://tiltbridge.readthedocs.io/en/master/User%20Guide/initial_setup.html>

## Related docs

* [Tilt Hydrometer](/integrations/tilt-hydrometer.md)
* [Devices](/devices.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.brewfather.app/integrations/tilt-hydrometer/tiltbridge-setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.