Version: 2023.2
Language : English
Using Unity through web proxies
Store credentials for automatic proxy configuration

Enable automatic proxy configuration

If your environment is compatible with Unity’s automatic proxy configuration feature, client computers must be configured to use it.

Review the solutions at Using Unity through web proxies to check if your environment supports Unity’s automatic proxy configuration feature.

Whether you enable Unity’s automatic proxy configuration feature manually or by using a more scalable method, configure client computers as follows:

  1. Check if the following directory exists on the client computer, and create it if it’s missing:

    • Windows: C:\ProgramData\Unity\config
    • macOS: /Library/Application\ Support/Unity/config
  2. Check if the directory in the previous step has a services-config.json file, and create it if it’s missing.

  3. Add the "enableProxyAutoconfig" key to the file and assign a value of true. If you’re creating the file, make sure it resembles the following example:

    {
        "enableProxyAutoconfig": true
    }
    
  4. Save the services-config.json file.

With automatic proxy configuration enabled, Unity applications will look for stored user credentials, if your organization’s web proxy requires authentication. If the credentials aren’t stored or aren’t correct, you’ll experience issues such as:

  • Project templates won’t be available in the Unity Hub when you create a new project.
  • Package Manager operations like searching or downloading packages will fail. In this case, the Editor displays error messages in the Console windowA Unity Editor window that shows errors, warnings and other messages generated by Unity, or your own scripts. More info
    See in Glossary
    :
Console errors after a failed proxy authentication
Console errors after a failed proxy authentication

Next steps

Additional resources

Using Unity through web proxies
Store credentials for automatic proxy configuration