Diagnose network issues

Run the Unity Package Manager Diagnostics tool to help diagnose common network issues.

Read time 2 minutes

Last updated 11 days ago

Use the Unity Package Manager Diagnostics tool to help diagnose common network issues associated with Unity Package Manager. The Diagnostics tool runs some basic network tests and creates files that the Unity support team needs to diagnose common network problems. After you run the tool, you can share the results with the Unity support team who can better guide you in resolving those issues.

To diagnose network issues:

Run the Unity Package Manager Diagnostics tool by using either the Unity Package Manager Error dialog or by Manually running the script.
View the test results in the shell window. The tool output also lists the location of the
```
upm-diagnostic-report.txt
```
report and the
```
upm-diag.log
```
file that it created.
If you need help from the Unity support team, include
```
upm-diagnostic-report.txt
```
and
```
upm-diag.log
```
when you submit a bug.

Method 1: Use the Unity Package Manager Error dialog

When Unity tries to launch, it starts the Package Manager process before it loads the project. If it encounters a critical error with Package Manager, Unity displays the following error message:

Critical error dialog appears prompting you for action

To run the Diagnostics tool, click Diagnose. Unity closes and launches the Diagnostics tool in a new window.

Method 2: Manually run the script

Locate the

RunUnityPackageManagerDiagnostics

script in the

Diagnostics

folder within the installation folder for your Unity Editor. To launch the tool, either run the script file from the command line or double-click the script file in your file browser.

Windows

The default path is:

<path-to-unity-installation-folder>\Editor\Data\Resources\PackageManager\Diagnostics\RunUnityPackageManagerDiagnostics.bat

Example:


"C:\Program Files\Unity\Hub\Editor\6000.3.5f1\Editor\Data\Resources\PackageManager\Diagnostics\RunUnityPackageManagerDiagnostics.bat"

macOS

Note

On macOS, you must right-click

Unity.app

and select Show Package Contents to access the contents of

Unity.app

The default path is:

<path-to-unity-installation-folder>/Unity.app/Contents/Resources/PackageManager/Diagnostics/RunUnityPackageManagerDiagnostics

Example:


/Applications/Unity/Hub/Editor/6000.3.5f1/Unity.app/Contents/Resources/PackageManager/Diagnostics/RunUnityPackageManagerDiagnostics

Documentation

Development

User Acquisition

Monetization

Industry

Unity Engine

User Manual

Script Reference