🛠️ Troubleshooting
This directory contains troubleshooting documentation for the homelab infrastructure.
📚 Documentation
- Comprehensive Troubleshooting Guide - Systematic approach to identifying and resolving common issues
- Common Issues - List of frequently encountered problems and solutions
- Disaster Recovery Improvements - Enhanced recovery procedures
- Emergency Access Guide - 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