# Troubleshooting

This directory contains troubleshooting guides and FAQs.

## Documents

- **[TROUBLESHOOTING_FAQ.md](TROUBLESHOOTING_FAQ.md)** ⭐⭐⭐ - Common issues and solutions - **Start here for problems**
- **[QBFT_TROUBLESHOOTING.md](QBFT_TROUBLESHOOTING.md)** ⭐⭐ - QBFT consensus troubleshooting

## Quick Reference

**Common Issues:**
1. Check TROUBLESHOOTING_FAQ.md for common problems
2. For consensus issues, see QBFT_TROUBLESHOOTING.md
3. For allowlist issues, see [../06-besu/BESU_ALLOWLIST_QUICK_START.md](../06-besu/BESU_ALLOWLIST_QUICK_START.md)

## Related Documentation

- **[../03-deployment/OPERATIONAL_RUNBOOKS.md](../03-deployment/OPERATIONAL_RUNBOOKS.md)** - Operational procedures
- **[../06-besu/](../06-besu/)** - Besu configuration
- **[../08-monitoring/](../08-monitoring/)** - Monitoring guides

