Version: 2021.1
Troubleshooting
Creating custom packages

Network issues

Using the Diagnostics tool

Use the Unity Package Manager Diagnostics tool to diagnose common network-related issues associated with Unity Package Manager. The Diagnostics tool runs some basic network tests that the Unity support team needs in order 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.

You can run the Unity Package Manager Diagnostics either through the Unity Package Manager Error dialog or by manually running the launch script.

After the Diagnostics tool finishes, it displays the results of the tests in the shell window. It also writes a log file and a report file, which you can open from the shell window:

Diagnostic report on top of the tool results in the shell window
Diagnostic report on top of the tool results in the shell window

After running Unity Package Manager Diagnostics, submit a bug and include the report.

Launch from 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
Critical error dialog appears prompting you for action

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

Launch via script

Locate the script in the Diagnostics folder under the Unity installation folder:

Operating system: Path to Diagnostics command-line tool:
Windows <path-to-unity-installation-folder>
   \Unity
      \Data
         \Resources
            \PackageManager
               \Diagnostics
                  \RunUnityPackageManagerDiagnostics.bat
macOS
Linux
<path-to-unity-installation-folder>
   \Unity.app
      \Contents
         \Resources
            \PackageManager
               \Diagnostics
                  \RunUnityPackageManagerDiagnostics

To launch the tool, either double-click the script file in your file browser or run it from the command line.

Troubleshooting
Creating custom packages