Sanitized mirror from private repository - 2026-04-05 10:15:27 UTC

docs/troubleshooting/README.md

@@ -0,0 +1,35 @@
+# 🛠️ 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*