Raspberry Pi Troubleshooting Hub¶
Choose the guide that matches the symptom. Each section provides checks to help identify the cause before changing the configuration.
Diagnostics & Troubleshooting Guides¶
- NetworkManager wait-online and slow boot — Inspect consumers, connection activation, and readiness before disabling a wait.
- OverlayFS changes lost and update problems — Verify actual mounts and maintain a persistent baseline.
- raspi-config command not found and nonint errors — Inspect the package, terminal, permissions, and exact option before applying settings.
- get_throttled values and undervoltage — Decode current and historical flags and verify power or cooling repairs.
- llama.cpp memory-lock errors — Inspect load modes, process limits, systemd settings, and OOM evidence.
- NetworkManager update errors and APT repair — Identify the package failure stage and preserve remote access.
- USB gadget missing usb0 or not detected — Diagnose the controller, gadget, host, network, and SSH layers.
Common Issues & Solutions
Resolve hardware and system errors including boot failures, Wi-Fi connectivity, static IP setups, and under-voltage warnings.
Performance TroubleshootingDiagnose and fix speed bottlenecks, CPU overload, memory pressure, ZRAM configuration, and thermal throttling.
Frequently Asked QuestionsQuick answers to common questions about headless setups, WayVNC remote desktop, security hardening, and password recovery.
Quick Diagnostic Flowchart¶
If you are unsure where to start, follow this quick diagnostic flow to locate the correct guide:
graph TD
A[Identify the Symptom] --> B{System Slow or Freezes?}
B -->|Yes| C{High Temperature?}
C -->|Yes, Over 80C| D[Go to Thermal Section in Performance Guide]
C -->|No| E[Check CPU, RAM, or Disk IO in Performance Guide]
B -->|No| F{Boot, Network, or Power Failure?}
F -->|Yes| G[Go to Common Issues Guide]
F -->|No| H[Search the FAQ Section]
style A fill:#4361ee,stroke:#3f37c9,stroke-width:2px,color:#fff
style D fill:#f72585,stroke:#b5179e,stroke-width:2px,color:#fff
style E fill:#f72585,stroke:#b5179e,stroke-width:2px,color:#fff
style G fill:#7209b7,stroke:#560bad,stroke-width:2px,color:#fff
style H fill:#4cc9f0,stroke:#4895ef,stroke-width:2px,color:#fff