Skip to main content

Troubleshooting

Unraid systems are designed for reliability, but issues can occasionally arise. This section will guide you through resolving common problems and provide best practices for effective troubleshooting.

Built-in help

The WebGUI offers detailed, context-sensitive help for nearly every setting. Click any field name or use the Help icon in the top right corner to access help for the entire page.

Stay informed

Enable notifications under Settings → User Preferences → Notification Settings to receive alerts about your system’s health. Unresolved issues can worsen if left unattended.

For additional support, the Unraid community forums are a fantastic resource. When seeking help, remember to:

  • Capture diagnostics before rebooting. Go to Tools → Diagnostics to generate a diagnostics file that preserves logs and system details necessary for troubleshooting.
  • Share the diagnostics file in a post on the Unraid forums to assist others in helping you effectively.