Stop manually adjusting your fermentation chamber temperature! This integration connects your Brewfather recipes to Home Assistant, automatically controlling your fermentation chamber to follow the exact temperature profile from your recipe.
Perfect for homebrewers who:
- ✅ Use Brewfather for recipe management and batch tracking
- ✅ Have a smart fermentation chamber (or want to build one)
- ✅ Want "set and forget" temperature control
- ✅ Don't want to miss temperature changes at 2 AM
- ✅ Want all their brewing data in their smart home dashboard
Designed for single batch fermentation - track one batch at a time with full automation support.
Set your fermentation chamber temperature based on your current Brewfather batch recipe. The integration reads your fermentation schedule and automatically adjusts your climate device to match.
Complete Dashboard Example | Automation Example
Never miss a brewing task! View all upcoming events in a calendar:
- Fermentation temperature changes
- Dry hopping schedules
- Bottling day reminders
- Custom brew events
Track your batch progress with real-time sensors:
- Current and upcoming target temperatures
- Fermentation start/end dates
- Days remaining until completion
- Recipe name and batch number
Receive data FROM Brewfather INTO Home Assistant:
- Temperature readings from devices attached to Brewfather (iSpindel, Tilt, etc.)
- Gravity readings from connected sensors
- Real-time fermentation data
Perfect for brewers with external devices (iSpindel, Tilt) connected to Brewfather who want to monitor their data in Home Assistant.
Access your brewing notes and track historical data directly in Home Assistant.
A ready-to-use dashboard featuring everything you need:
- 🌡️ Temperature Gauges - Current vs Target with visual indicators
- 🎛️ Thermostat Control - Full climate control for your fermentation chamber
- 📊 Progress Tracking - Batch info, start date, fermentation timeline
- 📈 Historical Graphs - 7-day history of temperature and gravity
- 📝 Batch Notes - Your brewing notes in formatted view
- 📅 Calendar View - All events in Home Assistant calendar
- ⏰ Next Events - Quick summary of upcoming tasks
- ✅ Sync Status - Visual confirmation temperature is correct
Uses only standard Home Assistant cards - no custom cards required!
Simply copy dashboard-complete.yaml and adjust climate.fermentation_chamber to your device.
All sensors update automatically every 15 minutes:
| Sensor | Description | Entity ID |
|---|---|---|
| Integration Status | Connection status and health check | sensor.brewfather_integration_status |
| Recipe Name | Name of your current fermenting beer | sensor.brewfather_recipe_name |
| Fermentation Start | When fermentation started | sensor.brewfather_fermentation_start |
| Target Temperature | Current target temp from recipe | sensor.brewfather_target_temperature |
| Upcoming Temperature | Next temperature step | sensor.brewfather_upcoming_target_temperature |
| Temperature Change Date | When next temp change occurs | sensor.brewfather_upcoming_target_temperature_change |
| Last Reading | Latest gravity/temp reading | sensor.brewfather_last_reading |
| Batch Notes | Your brewing notes | sensor.brewfather_batch_notes |
| Events | Upcoming brew events (count + details) | sensor.brewfather_events |
calendar.brewfather_events - All your brew events in Home Assistant's calendar
Add to dashboard:
type: calendar
entities:
- calendar.brewfather_eventsThe integration continuously monitors your Brewfather batch and provides the target temperature your fermentation chamber should be at. Combine this with the included automation to automatically adjust your climate device.
How it works:
- Integration reads your active Brewfather batch
- Calculates current target temperature based on fermentation schedule
- Updates
sensor.brewfather_target_temperatureevery 15 minutes - Automation compares target to actual and adjusts climate device
- Your beer ferments perfectly according to recipe!
Temperature Ramping Support: Enable this option to gradually increase/decrease temperature during ramp periods. For example, ramping from 20°C to 24°C over 2 days will increase 1°C every 12 hours instead of jumping immediately.
Example automation: sync_temperature.yaml
View all your brewing tasks in Home Assistant's calendar interface. The calendar automatically displays:
- Fermentation steps - When temperature changes occur
- Dry hopping - When to add hops
- Bottling day - When fermentation completes
- Custom events - Any events from Brewfather
Events are automatically filtered to show only active, future events. Supports both all-day events (Bottling Day) and timed events (Temperature Change at 14:00).
Access your Brewfather batch notes directly in Home Assistant. Perfect for:
- Quick reference during brew day
- Recording observations
- Tracking deviations from recipe
- Sharing notes in dashboards
Have devices (iSpindel, Tilt, temperature probes) connected to Brewfather? Enable Custom Stream to automatically receive their readings in Home Assistant.
How it works:
- Your device (iSpindel, Tilt) sends data to Brewfather
- Brewfather streams this data to Home Assistant via Custom Stream
- Data appears as sensor readings in Home Assistant
- Monitor temperature, gravity, and fermentation progress in your dashboard
Setup:
- Connect your device (iSpindel, Tilt) to Brewfather
- Enable "Custom Stream" in Brewfather app (Settings → Power-ups)
- Copy the logging ID from Brewfather
- Enable Custom Stream in this integration's configuration
- Enter the logging ID
- Data automatically syncs every 15 minutes
Supports temperature and gravity readings.
While designed for single batch operation, experimental multi-batch features are available:
- Multi-batch mode: Adds
other_batchesattributes to sensors - All batches data sensor: Complete API data for all fermenting batches
Note: These features are experimental and may change in future versions.
Configure via Home Assistant UI (Settings → Integrations → Brewfather → Configure):
Enable gradual temperature increases/decreases during fermentation ramp periods. Useful for precise temperature control during multi-step fermentations.
Receive temperature/gravity data from Brewfather devices into Home Assistant. Requires:
- Device (iSpindel, Tilt, etc.) connected to Brewfather
- Brewfather Custom Stream logging ID
- Automatic unit conversion and validation
Track multiple fermenting batches with additional sensor attributes. Not recommended for automation purposes.
Creates sensor with complete API data for all batches. Useful for custom dashboards and templates.
- Make sure HACS is installed
- Go to HACS → Integrations
- Search for "Brewfather"
- Click "Download"
- Restart Home Assistant
- Go to Settings → Integrations → Add Integration
- Search for "Brewfather"
Or click here: Add Brewfather Integration
- Copy
custom_components/brewfatherfolder to your Home Assistant'scustom_componentsdirectory - Restart Home Assistant
- Go to Settings → Integrations → Add Integration → Brewfather
Enter your Brewfather credentials:
- Connection name: Friendly name for this connection (e.g., "My Brewery")
- User ID: Your Brewfather User ID (found in Settings → API)
- API Key: Generate from Brewfather Settings → API → Generate API Key
Required API Scope: batches:read
Select which features to enable:
- ☑️ Temperature ramping - Gradual temp changes during ramps
- ☑️ Custom stream - Receive data from Brewfather devices
- ☐ Multiple batch support - Experimental multi-batch tracking
- ☐ All batches data sensor - Complete API data sensor
Configure Brewfather-to-Home Assistant streaming:
- Logging ID or Stream URL: From Brewfather Custom Stream settings
- Integration receives data from devices connected to Brewfather (iSpindel, Tilt, etc.)
The integration validates your configuration and tests the connection.
Full translation support for:
- 🇺🇸 English (Default)
- 🇫🇷 Français (French)
- 🇪🇸 Español (Spanish)
- 🇳🇱 Nederlands (Dutch)
- 🇩🇪 Deutsch (German)
- 🇮🇹 Italiano (Italian)
- 🇵🇹 Português (Portuguese)
- 🇧🇷 Português Brasileiro (Brazilian Portuguese)
The interface automatically uses your Home Assistant language setting.
- Open Brewfather app or web interface
- Go to Settings → API
- Click Generate API Key
- Give it a name (e.g., "Home Assistant")
- Select scope: Read Batches (minimum required)
- Copy the generated User ID and API Key
Official Brewfather API Documentation
Important: Breaking changes! All sensors have been renamed.
- Sensor entity IDs now use
brewfather_prefix - Integration status sensor added
- Improved error handling and validation
- Multi-language support
- Before upgrading: Note which automations/dashboards use Brewfather sensors
- Upgrade via HACS
- Update entity IDs in your automations and dashboards:
- Old:
sensor.recipe_name→ New:sensor.brewfather_recipe_name - Old:
sensor.target_temperature→ New:sensor.brewfather_target_temperature
- Old:
- Test your automations
Found a bug? Have a feature request?
- Issues: GitHub Issues
Enjoying this integration? Buy me a beer! 🍺
Happy Brewing! 🍻
