Maintenance & Recovery

General Troubleshooting

Diagnose one layer at a time instead of rebuilding a working server because one application is unavailable.

Guide difficulty⭐⭐⭐⭐⭐ Beginner Friendly
Estimated time⏱️ Around 20–40 minutesEstimated for a first-time user.

Use this order

  1. Power: are the Pi, HAT and drives powered?
  2. Network: does the server answer on its local IP?
  3. Storage: is the expected mount present?
  4. Docker: is the container running?
  5. Application: what does its own log say?
  6. Proxy: does it work locally but fail remotely?
uptime
ip addr
findmnt
df -h
docker ps -a
IMAGE PLACEHOLDERTroubleshooting decision tree covering power, network, storage, Docker, application and remote access.
Required image: Troubleshooting decision tree covering power, network, storage, Docker, application and remote access.