Home
The complete handbook for your self-hosted mead-brewing workspace.
MeadOS is a self-hosted application that follows a batch of mead from must to mature bottle — recipes, fermentation readings, nutrient schedules, inventory, cellar locations, tasting notes, labels and aging milestones, all in one browser-based workspace backed by a single SQLite database.
This wiki is the in-depth manual. For a quick overview and installation summary, see the project README.
| Page | What's inside |
|---|---|
| Installation & Running | Requirements, first run, ports, running it as an always-on service |
| Getting Started | Your first batch, the day-to-day flow, where everything lives |
| Page | What's inside |
|---|---|
| Recipes & Designer | The 38 built-in recipes, the honey/yeast/nutrient ratings, scaling, custom recipes, the Recipe Designer, BeerXML & PDF |
| Batches & Fermentation | Creating batches, logging gravity, the gravity/ABV chart, status tracking, stall detection, guided bottling |
| Brewing Tools | Every calculator — ABV, TOSNA 2.0, sulfite, acid, carbonation, backsweetening and more |
| Formulas & Methods | The maths behind every number — recipe scaling, gravity, ABV, nutrients, sulfite, carbonation — with worked examples |
| Libraries | Honey varieties, yeast strains and nutrient protocols |
| Cellar & Inventory | The visual cellar, drinking windows, supplies, suppliers, costs and "brew with what you have" |
| Labels, Sharing & Calendar | Bottle/box labels, QR codes, public share pages and the calendar feed |
| Page | What's inside |
|---|---|
| Home Assistant | Optional temperature, hydrometer and notification integration |
| Security & Deployment | External access, the password, built-in hardening, reverse proxies and trusted networks |
| Backups & Data | What's stored where, the history table, restoring, exporting and importing |
| Page | What's inside |
|---|---|
| FAQ | Frequently asked questions |
| Troubleshooting | Stuck ferments, off-flavours, and app/server issues |
MeadOS is free to use, modify and share for any noncommercial purpose under the PolyForm Noncommercial License 1.0.0. Selling it or using it for commercial advantage is not permitted.