# WiredTiger error: checkpoint stall detected: unable to create checkpoint within 60 seconds

- **ID:** `mongodb/wiredtiger-checkpoint-stall`
- **Domain:** mongodb
- **Category:** system_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

High write load or disk I/O contention prevents WiredTiger from completing a checkpoint within the configured timeout.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| MongoDB 6.0 | active | — | — |
| MongoDB 7.0 | active | — | — |
| MongoDB 8.0 | active | — | — |

## Workarounds

1. **Monitor disk I/O with iostat or MongoDB's serverStatus().wiredTiger.concurrentTransactions and upgrade to faster storage (e.g., NVMe SSDs) if needed.** (75% success)
   ```
   Monitor disk I/O with iostat or MongoDB's serverStatus().wiredTiger.concurrentTransactions and upgrade to faster storage (e.g., NVMe SSDs) if needed.
   ```
2. **Reduce write load by throttling application writes or using write concerns with lower durability (e.g., w:1 instead of w:majority).** (70% success)
   ```
   Reduce write load by throttling application writes or using write concerns with lower durability (e.g., w:1 instead of w:majority).
   ```
3. **Increase checkpoint timeout via storage.wiredTiger.engineConfig.checkpointWaitTimeoutSecs in the configuration file.** (80% success)
   ```
   Increase checkpoint timeout via storage.wiredTiger.engineConfig.checkpointWaitTimeoutSecs in the configuration file.
   ```

## Dead Ends

- **** — Smaller cache increases I/O pressure, potentially stalling checkpoints more. (70% fail)
- **** — Checkpoints are still needed for durability; disabling journaling doesn't eliminate checkpoint requirement. (80% fail)
- **** — Longer intervals may accumulate more dirty data, making checkpoints even slower. (60% fail)