Data Safety
This guide covers the practical recovery tools available in Brewfather today:
Exporting a full JSON backup
Importing backup data safely
Restoring from history
Offline and connection recovery settings
Where to find these tools
Open Settings and use these sections:
Data
Export user data to JSON
Import user data from JSON
View and restore historic data
Application
Offline Support
Clear Offline Storage
Alternative connection mode
1) Export a full backup (web)
Use Settings → Data → Export user data to JSON.
What the export includes:
Recipes
Batches
Profiles (equipment, mash, fermentation, water, custom styles)
Inventory (fermentables, hops, miscs, yeasts)
Your current settings
Notes:
Export is currently shown in the web app flow.
Export is Premium-gated.
Keep your JSON backup file in a safe place.
2) Import backup data (web)
Use Settings → Data → Import user data from JSON, then choose your backup file.
After loading a valid Brewfather backup, Brewfather lets you choose exactly what to import (recipes, batches, inventory groups, and profile groups).
Important behavior:
Imports are Premium-gated and require an active premium state.
Imported data can overwrite existing data.
You do not have to import everything; select only what you need.
Current per-import caps in the app:
Recipes: up to 2000
Batches: up to 2000
Each inventory/profile category: up to 1000
3) Restore from History
Use Settings → Data → History.
History currently provides:
Limited change history for batches
Delete history for recipes
Date-based filtering (select a day first)
Up to 250 entries for the selected day
When you open an entry, you can restore to:
Before the selected change, or
After the selected change
Restore safeguards:
Restore actions are Premium-gated.
Brewfather asks for confirmation and requires typing
CONFIRM.Restoring replaces current data for that item, so newer changes to that item are lost.
4) Offline and connection recovery tools
Offline Support
This is a device-level setting.
In current app behavior it is disabled by default unless you explicitly enable it.
Turning it on/off requires a reload to fully apply.
Clear Offline Storage
Removes locally stored cached data on this device.
Brewfather warns that unsynced data can be lost.
Alternative connection mode
Device-level fallback mode for connectivity problems.
Brewfather warns this mode can reduce network performance.
Use it only if you have persistent connection issues.
Practical recovery checklist
If something looks wrong or missing:
Stop making edits.
Export your current data to JSON (web).
Open History and check whether a restore is enough.
If needed, import only the specific backup categories you want to recover.
If you are troubleshooting connectivity, try Alternative connection mode temporarily.
If local cache is corrupted/stale, use Clear Offline Storage and reload.
Related docs
Last updated
Was this helpful?