# Diagnose network issues

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

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:

1. Run the Unity Package Manager Diagnostics tool by using either the [Unity Package Manager Error dialog](#UILaunch) or by [Manually running the script](#ScriptLaunch).

2. 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.

3. If you need help from the Unity support team, include `upm-diagnostic-report.txt` and `upm-diag.log` when you [submit a bug](https://unity3d.com/unity/qa/bug-reporting).

## 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:**
![](/api/media?file=/engine/6000.6/media/images/upm-network.png)

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](https://docs.unity.com/hub/add-editor.md#manage-editor-installs). 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:

```bash
"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:

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

## Sample output


**Diagnostic report on top of the tool results in the shell window:**
![](/api/media?file=/engine/6000.6/media/images/upm-network-diagnostics.png)

## Additional resources

* [Configuring your firewall](/engine/6000.6/manual/packages-list/upm-config/network.md#Firewall)
* [Configuring your proxy server](/engine/6000.6/manual/packages-list/upm-config/network.md#Proxy)