The cocoa fermentation batch calculator sizes a fermentation box or heap to a given weight of wet bean and predicts how the batch will behave over its five to seven days: the depth to fill, the peak temperature to expect, how many turns it needs, and the day it should reach a proper fermentation index. It removes the guesswork from the step that decides whether beans develop chocolate flavor or turn flat and moldy.
Loading calculator...
Fermentation is where flavor precursors form. Get the depth and turning wrong and the beans in the middle overheat while the edges stay raw, leaving a batch that grades poorly no matter how carefully it was grown. The physical mass of wet bean, its depth, and the ambient temperature together set the pace, and this tool models that relationship so a farmer can plan boxes and labor before harvest day.
Whether you ferment in a wooden box, a plantain-leaf heap, or a cascade of stacked trays, the same core variables apply: mass, depth, air, temperature, and time. The calculator works from what you can control and returns the schedule to aim for.
π« How to use the cocoa fermentation batch calculator
Begin with the wet bean weight, the fresh mass coming from your breaking station. The default is 90 kilograms, which matches roughly 1,000 pods. Every sizing output scales from this, because a ferment is fundamentally a volume of heat-generating bean.
Choose the box or heap method. Boxes hold heat well and drain neatly, and suit larger, regular batches. Heaps wrapped in leaves suit smallholders with variable volumes. The method changes the assumed heat retention and therefore the peak temperature the model predicts.
Set the bean depth. This is the single most important control a fermenter has. Too shallow and the mass never reaches the temperatures that drive the reactions; too deep and the core cooks. The default of 45 centimeters sits in the workable band for most box ferments.
Aim for a fill depth where a hand pushed into the mass on day two meets warmth all the way down, not a hot core wrapped in a cool shell. Depth, not box footprint, is what you tune.
Enter the ambient temperature. Cocoa ferments faster and hotter in a warm climate and stalls in a cool one, so a highland farm at 22 degrees Celsius will run a slower schedule than a lowland farm at 30. As you raise this, the predicted ready date pulls earlier.
The turning schedule sets how often you mix the mass to aerate it and even out temperature. More turns give a more uniform ferment but cost labor. Finally, fermentation days sets your target duration, typically 5 for Forastero and 6 to 7 for Criollo and Trinitario, and the model reports whether that window reaches a proper index.
π« Calculator fields explained
Wet bean weight (kg) – Fresh mass of pulp-covered bean to ferment. Default 90 kg. Drives box volume and fill depth.
Box or heap method – Select the fermentation vessel. Box (default) retains heat and drains well; heap suits smaller, irregular volumes with leaf wrapping. The choice sets heat-retention assumptions.
Bean depth (cm) – Target fill depth of the bean mass. Default 45 cm, workable range 30 to 60 cm. Below 30 the mass runs cool; above 60 the core overheats.
Ambient temperature – Local air temperature during fermentation, in degrees Celsius. Default 28. Warmer air speeds the ferment and raises peak temperature.
Turning schedule – How often the mass is mixed: for example every 48 hours (default), every 24 hours, or minimal. More frequent turning improves uniformity and oxygen supply.
Fermentation days – Planned duration in days. Default 6. Sets the target for the ready-date and fermentation-index outputs.
π« Understanding the results
| Result | What it means | What it drives |
|---|---|---|
| Box volume needed | Interior volume to hold the mass at target depth | Box construction or selection |
| Fill depth | Actual bean depth given your box footprint | Heat and uniformity of ferment |
| Expected peak temperature | Highest core temperature during the run | Flavor development, over-fermentation risk |
| Turn count | Number of turns over the schedule | Labor planning |
| Fermentation index | Modeled completeness of fermentation | Quality grade, ready decision |
| Ready date | Day the batch should be drained to drying | Drying-bed scheduling |
The hero number is the expected peak temperature, which should land between 45 and 50 degrees Celsius for a clean ferment. Below 42 the reactions stall and the beans stay purple and bitter; above 52 the batch risks off-flavors and hammy notes.
Box volume and fill depth are the build numbers. If the calculator returns a fill depth of 70 centimeters for your box footprint, the box is too small in area, and you either build wider or split the batch.
Turn count converts the schedule into labor. Turning 90 kilograms by shovel is real work, and knowing you face three turns rather than one lets you line up help before the beans are in the box.
A peak temperature above 52 degrees Celsius signals over-fermentation risk, and beans pushed past it develop off-flavors no roaster can remove.
The fermentation index models how complete the process is by the ready date. A low index paired with your chosen day count means the batch needs longer, and pulling it early leaves under-fermented, astringent beans.
Core temperature should peak between 45 and 50 degrees Celsius.
Read the extremes with care. A shallow, cool ferment reads as a low peak temperature and a low index, telling you to deepen the mass or wait. A deep, hot ferment reads as a high peak and warns you to turn more often and possibly drain a day early.
π« Calculation formulas
Volume comes from mass and bulk density; depth comes from volume and footprint; temperature and index are modeled from depth, ambient temperature, and turning. Illustrative forms follow.
Box volume (L) = wet weight (kg) / bulk density (kg/L)
Fill depth (cm) = volume (L) / footprint area (dm2) x 10
Peak temp = ambient + depth factor x depth - turning penalty
Turn count = fermentation days / turning interval (days)
Worked with defaults: 90 kilograms at a bulk density near 0.6 kg per liter gives about 150 liters. For a box footprint of 0.5 square meters, that is a fill depth around 30 centimeters. With an ambient of 28 and a depth factor that adds warmth as the mass deepens, the peak lands near 47 degrees. Turning every 48 hours across 6 days gives 3 turns.
Bulk density of wet, pulpy beans sits near 0.55 to 0.65 kilograms per liter. Beans plus mucilage pack loosely, which is why 90 kilograms fills more volume than its weight suggests.
The parameters below are the reconstructed values. Correct them here once the shipped code is confirmed, and the examples update with them.
| Parameter (verify against code) | Illustrative value | Used for |
|---|---|---|
| Wet bean bulk density | 0.6 kg/L | Volume |
| Target peak temperature | 45 to 50 C | Quality band |
| Over-fermentation threshold | 52 C | Warning |
| Minimum effective depth | 30 cm | Heat generation |
| Maximum safe depth | 60 cm | Core overheating |
| Default turning interval | 48 h | Turn count |
| Default duration | 6 days | Ready date |
π« Practical examples
Each scenario uses valid inputs and the formulas above, ending with the fermenter’s next action.
Home batch, one tray. Inputs: 5 kg wet, heap method, 25 cm depth, 27 C, minimal turning, 5 days. Volume about 8 liters. The depth is below the 30 cm floor, so the model warns of a cool ferment. The hobbyist insulates the heap with extra leaves to hold heat.
Backyard sweatbox. Inputs: 15 kg wet, box, 30 cm, 28 C, every 48 h, 5 days. Volume 25 liters, peak near 44 C, index adequate. Small but workable, so the grower runs it as planned and drains on day 5.
Smallholder single box. Inputs: 90 kg wet, box, 45 cm, 28 C, every 48 h, 6 days. Volume 150 liters, peak near 47 C, 3 turns, ready day 6. The farmer schedules helpers for three turning sessions and books drying beds for day 6.
Cool highland farm. Inputs: 90 kg, box, 50 cm, 22 C, every 48 h, 7 days. The low ambient drags the peak toward 44 C, so the model extends the index timeline. The grower deepens the mass slightly and plans a 7 day run.
The thermometer, not the calendar, tells you when a ferment is done. Plan the days, but drain on the temperature and the cut test.
Warm lowland farm. Inputs: 90 kg, box, 45 cm, 31 C, every 24 h, 5 days. Warm air and frequent turning push a fast, hot ferment peaking near 50 C. The farmer turns daily and checks for over-fermentation from day 4.
Cooperative bulk box. Inputs: 300 kg, box, 55 cm, 29 C, every 48 h, 6 days. Volume 500 liters, peak near 49 C. A 300 kg box holds roughly 500 liters of pulpy bean. The manager confirms the box interior and lines up a crew for heavy turning.
Criollo fine-flavor batch. Inputs: 60 kg, box, 45 cm, 27 C, every 48 h, 7 days. Criollo needs a gentler, longer ferment, so the target duration is 7 days and the grower watches for a lower peak that still reaches a clean index.
Edge case, overloaded box. Inputs: 200 kg forced into a box giving 75 cm depth, 30 C, every 48 h, 6 days. The depth exceeds the 60 cm ceiling, the model flags core overheating past 52 C, and the fermenter splits the load into two boxes rather than risk a scorched center.
π« Tips and best practices
Tune depth before anything else. A box that is wide and shallow behaves completely differently from a narrow deep one at the same weight, and depth is the lever that sets whether the mass reaches fermentation temperature. Keep it in the 30 to 60 centimeter band and adjust footprint to hit it.
Turn on a schedule you can actually keep. A plan of daily turns that you skip because labor did not show up is worse than a realistic 48 hour plan you follow, because uneven turning leaves hot and cold pockets. Match the turning field to the crew you truly have.
Insulate heaps in cool weather. A leaf-wrapped heap in highland air loses heat fast, and a jute cover or extra banana leaves can lift the peak by several degrees, the difference between a stalled and a complete ferment.
Push a probe thermometer into the center twice a day and log the reading. A temperature curve that climbs then plateaus near 48 degrees is the signature of a ferment going right.
Do a cut test before draining. Slice a handful of beans and look for brown interiors rather than purple or slaty, because color is the ground truth the model only estimates. Drain to drying promptly once the index and cut test agree, since beans left wet past their peak sour and mold. And never mix a fresh harvest into a ferment already underway, because the two masses are on different clocks and the combined batch finishes unevenly.
β οΈ Common mistakes to avoid
Fermenting too shallow
Spreading beans thin to fit an awkward box keeps the mass below the temperature the reactions need. The result is purple, bitter beans that never developed flavor.
A ferment that never crosses 42 degrees Celsius in the core is not slow, it is failing. The beans will grade as under-fermented no matter how many days you wait.
Deepen the mass to at least 30 centimeters, splitting into a smaller footprint if needed.
Skipping turns
Leaving the mass unturned starves the interior of oxygen and lets temperature and acidity pool unevenly.
An unturned box ferments like three different batches stacked together, and the buyer grades it on the worst layer.
Commit to a turning interval you can staff, and hold to it.
Draining by the calendar alone
Pulling a batch on day 6 because the plan said so, without checking temperature or a cut test, risks draining an under- or over-fermented mass. Draining a day too early leaves astringent, under-fermented beans.
Let the thermometer and cut test confirm the calendar before you drain.
Overloading a single box
Cramming too much weight into one box drives the depth past the safe ceiling and cooks the core. Split large harvests across boxes rather than stacking depth.
Ignoring ambient temperature
Running a highland ferment on a lowland schedule pulls the batch early before it has reached its index. Set the ambient field honestly and let the ready date shift.
Mixing harvests mid-ferment
Adding fresh beans to a working box resets part of the mass to day zero while the rest is finishing. Ferment each harvest as its own batch.
π« When to use this calculator
Use it before harvest when you are deciding how many boxes to build or borrow and how to staff turning. The sizing and turn-count outputs let you commit structure and labor to a known batch weight rather than improvising on breaking day.
It also helps when you move to a new site or season and the ambient temperature shifts. A farm that adds a highland block cannot assume its lowland schedule holds, and the model shows how the ready date stretches in cooler air.
Flavor is made in the ferment, not the roast. A roaster can only reveal what fermentation put there.
It is less useful for a tiny personal batch where you will simply wrap a heap and check it by feel. And it predicts physics, not flavor chemistry, so it guides temperature and timing but never replaces the cut test and your own palate. Pair it with the drying loss tool to plan the step that follows.
π« Related calculators
Cocoa Pod to Bean Yield, Cocoa Drying Loss, Cocoa Bean to Bar Cost, Cocoa Nibs Liquor Conversion, Cocoa Farmgate Revenue, Cocoa Tree Yield, Cocoa Farm ROI
π« Glossary
Fermentation – Microbial breakdown of pulp that develops flavor precursors in the bean.
Sweatbox – A wooden box used to ferment cocoa, allowing drainage of liquid.
Heap method – Fermenting beans in a leaf-covered pile rather than a box.
Turning – Mixing the mass to aerate it and even out temperature.
Peak temperature – The highest core temperature reached, ideally 45 to 50 C.
Cut test – Slicing beans to judge fermentation by interior color.
Fermentation index – A measure of how complete the process is.
Why does depth matter more than box size? Because heat generation depends on how deep the mass sits, not how wide, and depth is what a fermenter actually controls.
Slaty bean – An under-fermented bean with a compact, greyish interior.
Over-fermentation – Fermenting past the flavor peak, producing off-notes.
Mucilage – The pulp whose sugars feed the fermenting microbes.
Bulk density – Mass per unit volume of the loose bean mass.
Aeration – Introducing oxygen, mainly through turning.
Ambient temperature – Surrounding air temperature during the ferment.
β Frequently asked questions
How long should cocoa ferment?
Most Forastero ferments run 5 days, while Trinitario and Criollo often need 6 to 7 to develop fully.
Climate shifts this: a cool highland ferment can need an extra day or two to reach the same index a warm lowland batch hits in five.
What peak temperature should I aim for?
A clean ferment peaks between 45 and 50 degrees Celsius in the core.
Below 42 the reactions stall and beans stay purple; above 52 the batch risks hammy off-flavors that carry through to the finished chocolate.
How deep should the bean mass be?
Between 30 and 60 centimeters. Shallower runs too cool to ferment; deeper cooks the center.
If your box footprint forces a depth outside that band, change the footprint or split the batch rather than accepting a bad depth.
How often should I turn the beans?
Turning every 48 hours is a common baseline, with the first turn around 48 hours after loading.
Daily turning gives a more uniform ferment but doubles the labor, so match the interval to the crew you can actually field on turning days.
Whatever interval you choose, keep it consistent, because irregular turning is worse than a steady lighter schedule.
Box or heap, which is better?
Boxes retain heat and drain well, suiting larger regular batches, while heaps suit smallholders with variable volumes.
A heap of only a few kilograms struggles to hold heat, so very small batches often benefit from a well-insulated box or extra leaf wrapping.
How do I know when to drain?
When the peak temperature has plateaued and a cut test shows mostly brown interiors rather than purple or slaty.
The calculator’s ready date is a plan, but the cut test is the decision, so trust the beans over the calendar.
Can I ferment in plastic instead of wood?
Plastic works but retains less breathability and can trap moisture, so drainage holes and turning matter more.
Wood is traditional partly because it wicks liquid and hosts a resident microbial community, which many fermenters credit for consistent results.
Does over-fermentation ruin a batch?
It can. Pushing past the flavor peak produces ammonia and hammy notes that no roasting step removes.
Watch for peaks above 52 degrees and a strong ammonia smell, and drain promptly rather than adding days for their own sake.
βοΈ Disclaimer
This tool offers educational and agricultural planning guidance for fermentation. Real ferments depend on cultivar, pulp sugar, microbial community, weather, and vessel, so your results will vary from any modeled figure.
The parameters here were reconstructed without the calculator’s source code and are illustrative. Confirm each value against the shipped code before using the outputs to plan commercial batches.
Fermentation temperature and timing affect food quality; follow local food-safety guidance and do not treat modeled temperatures as a substitute for a probe thermometer and cut test.
Consult a local extension officer or a cocoa quality specialist before changing an established fermentation protocol on a commercial scale.
