35 lines
1.2 KiB
Markdown
35 lines
1.2 KiB
Markdown
# 🛠️ 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* |