# 🛠️ Troubleshooting

This directory contains troubleshooting documentation for the homelab infrastructure.

## 📚 Documentation

- [Comprehensive Troubleshooting Guide](comprehensive-troubleshooting.md) - Systematic approach to identifying and resolving common issues
- [Common Issues](common-issues.md) - List of frequently encountered problems and solutions
- [Disaster Recovery Improvements](DISASTER_RECOVERY_IMPROVEMENTS.md) - Enhanced recovery procedures
- [Emergency Access Guide](EMERGENCY_ACCESS_GUIDE.md) - Emergency access when normal procedures fail

## 🚨 Quick Reference

### Network Issues
- Check Tailscale status (`tailscale status`)
- Verify firewall rules allow necessary ports 
- Confirm DNS resolution works for services

### Service Failures
- Review container logs via Portainer
- Restart failing containers
- Check service availability in Uptime Kuma

### Backup Problems
- Validate backup destinations are accessible
- Confirm HyperBackup tasks are running successfully
- Review Backblaze B2 dashboard for cloud backup errors

### System Monitoring
- Check Grafana dashboards for resource utilization
- Monitor Uptime Kuma for service downtime alerts
- Review Docker stats in Portainer

---
*Last updated: 2026*