Fix a machine
The machine is misbehaving
Start with the symptom you can see, then work through the checks in order.

Home Coffee Notes · Home espresso
Grind, dose, yield, and time — one starting point you can run today.
Learning to dial in home espresso starts with a fixed 1:2 recipe and one grind move at a time. Home Coffee Notes publishes practical dial-in steps, troubleshooting notes, and calculators for home espresso.
Pick a taste signal. The matching card lights up. Dose and yield stay locked while grind does the work.
If your basket marks a different dose range, keep 1:2 and shift dose inside that range. Freshness, roast, water, and heat-up all move the window.
How does the cup read?
Next move
Sour, thin, or harsh-bright cups often run fast under the time window.
Keep dose + yield fixed. One small step. Clear the burrs.
Next move
Bitter, drying, or hollow-roast cups often crawl past the window or stall.
Keep dose + yield fixed. One small step. Taste again.
Prep first
Spurts, early blonding in one spot, or one-sided flow are prep signals.
Distribute, level tamp, then revisit grind.
Time tells you flow. Taste tells you the move. Burr marks are not interchangeable across grinders — treat every click as local to your burr set and beans.
Pick the job in front of you. Each link goes to a guide or calculator kept on this site.
Fix a machine
Start with the symptom you can see, then work through the checks in order.
Choose a machine
Compare workflow and total cost before comparing model names.
Brew and measure
Set a ratio you can repeat, then adjust one variable at a time.
Calculate
Run your own dose, cost or label figures through a focused tool.
Browse the complete article archive for every published post.
Cards you can act on — not another long tutorial.
01
Hold dose and yield. Move grind only. Finer for sour-fast; coarser for bitter-slow.
02
Espresso-range steps, a scale on dose and cup, and honest basket behavior beat another unmetered shot.
03
Match dose to the basket’s intended range. Pressurized baskets mask grind errors; non-pressurized teach taste.
04
Weigh → dry basket → distribute → level tamp → clean flange → start pump and timer together → stop on yield.
05
Three disciplined shots. Same dose, same yield, only grind moves. Tag sour / balanced / bitter and stop when the cup is worth drinking.
Practical starting points drawn from published brewing guidance and manufacturer documentation.
Ratios, time windows, and machine guidance are checked against manufacturer documentation and established brewing references.
The starting card is a place to begin, not a measurement of your machine. Adjust it to your beans, basket and grinder, and use the manual for model-specific questions.
The method is deliberately narrow: hold dose and yield, change grind, taste the cup, and keep a written record.
Free to read. Where a question depends on your specific machine, the manual and the manufacturer remain the authority.
Medium-fine espresso territory, then the 18 g in / 36 g out recipe. Judge by time and taste — not a universal click number.
If dose, yield, and grind move together, you cannot tell which change fixed the cup. 1:2 holds ratio steady so grind is the extraction lever.
Too fine often slows or stalls and pushes bitterness. Too coarse often finishes early and tastes sour or thin. Confirm with a scale.
Not on day one. Stabilize puck prep and grind against a fixed 1:2 recipe before advanced temperature or pressure tweaks.
When shots are enjoyable and repeatable, or the grinder cannot step finely enough to enter the time window. At that point the next step is your machine's manual or a repair professional, not another grind chase.
Once the recipe is steady, pick the symptom you actually have. Each page below is a machine check kept on this site.
The symptom shows up on the machine before it shows up in the cup.
A Breville steam wand that goes quiet after a descale cycle, checked in order.
Barista Express flow that drops after cleaning, worked through as a safe checklist.
The machine runs, but the basket and the shot disagree.
Barista Express grinder symptoms — no grind, jamming, or a setting that moved.
Dose, basket and shot timing when a Breville puck comes out wet.

Log dose, yield, time, and the last grind step that worked. Then use the notes and calculators here to compare one change at a time — not to chase a number that does not fit your beans or basket.