NZBGet SystemHealth: Configuration and Environment Diagnostics

SystemHealth is a built-in diagnostic tool found on the NZBGet Status page. It helps to configure the software correctly for the first time, and advanced users to fine-tune their existing setups.

When NZBGet starts, SystemHealth automatically runs checks to validate your settings. These checks help detect common configuration problems and ensure your system is working correctly.

SystemHealth can help you:

  • Detect conflicting settings or missing software dependencies
  • Identify configuration values that may reduce performance
  • Identify filesystem or hardware-compatibility issues

Severity Levels

SystemHealth reports are grouped into three categories to help you prioritize any necessary fixes:

  • 🔴 Error: Critical issues that prevent NZBGet from working properly. Example: No news servers are configured or an empty DestDir). Errors are marked with a red exclamation mark on the Settings and Status tabs, along with a numbered red badge.
  • 🟡 Warning: Non-critical issues that might impact performance or cause minor stability problems. Fixing warnings is recommended for most setups, though some advanced configurations may intentionally ignore them.
  • 🟢 Info: General system details. This section displays your current settings, automated processes, and recommendations for security and optimization.

How to Enable or Disable SystemHealth

SystemHealth checks run automatically by default. You can enable or disable them in settings:

Go to: Settings → Logging → SystemHealthCheck

Check your Status page to see your current SystemHealth report and ensure your NZBGet environment is configured correctly.

Introduction

Installation manuals

Building manuals

Configuration

Performance tuning

Usage

Development

Extensions

News server setup

Other helpful guides

/js/scripts.min.js