Installing the Unity Hub

The Unity Hub is a management tool that allows you to manage all of your Unity projects and installations. Use the Hub to manage multiple installations of the Unity Editor along with their associated components, create new Projects, and open existing Projects.

To install the Unity Hub, visit Download Unity Personal on the Unity website.

To install and use the Unity Editor, you must have a Unity Developer Network (UDN) account. If you already have an account, sign in, choose your licenses type, and proceed to the Installing the Unity Editor section.

If you do not have an account, follow the prompts to create one. You can choose to create a Unity ID or use one of the social sign-ins. For more information on accounts and subscriptions, see Unity Organizations.

Installing the Unity Editor

To install the Editor:

1. Click the Installs tab. The default install locations are:

   Windows:

   C:\Program Files\Unity\Hub\Editor
   

   Mac:

   /Application/Unity/Hub/Editor
   

   1. Optionally, to change the default installation location, click the Gear icon.

   2. In the Editor Folder Location dialog box, enter the new installation location and click Done.

2. Click Official Releases for released versions of the Editor, or Beta Releases for the latest Beta release of the Editor.

   

3. Click the Download button of the Editor version to install. This opens a dialog box called Add components to your install.

4. In the Add components to your install dialog box, select the components to install with the Editor, and click Done. If you don’t install a component now, you can add it later if you need to.

   

If you are installing multiple Editor versions, the first installation starts as soon as the download is complete. Other selected versions download simultaneously and queue to start when the current installation finishes.

The Hub displays the installation location of each Editor under the corresponding version label.

To set it an Editor version as your preferred version, add components to it, or uninstall it, click the three dots next to that Editor version.

If you remove or uninstall the preferred Editor version, another installed Editor version becomes the preferred version.

Adding existing instances of the Editor to the Hub

You can add instances of the Editor to the Hub that you installed outside of the Hub.

1. Click the Installs tab.
2. Click the On my machine tab. To find existing installations of the Editor, click Locate a Version.
3. In the file dialog, navigate to the location of the Editor installation and select the Unity executable. On MacOS this is Unity.app. On Windows this is Unity.exe.

On macOS, the typical location of the Unity.app is:

/Applications/Unity/Hub/Editor/<version>/Unity.app

On Windows, the typical location of the Unity.exe is:

C:\Program Files\Unity\Editor\Unity.exe

Or

C:\Program Files\Unity<version>\Editor\Unity.exe

1. Click the Select editor button.

To set the Editor as the preferred version, or to remove the Editor from the Hub, click the three dots next to the Editor version.

Removing an Editor that you added in this manner does not uninstall it or modify it in any way.

Support for Editor versions prior to 2017.1

Sign in status is not shared for pre–2017.1 versions of the Editor opened through the Hub. Performing tasks such as Manage License, Open Project, Create Project, and Sign in opens the Unity Launcher instead of the Hub.

If you attempt to use the Unity Hub to open an Editor version 5 or earlier and you do not have an appropriate license file, the Editor will hang on the splash screen.

To avoid this issue, run the Editor directly, external to the Unity Hub, and the Editor will load correctly even if the license file is not detected.

Using the Unity Installer to install the Unity Editor

The Unity installer is a small executable program (approximately 1 MB in size) that lets you select which components of the Unity Editor you want to download and install.

To install previous versions of the Unity Editor using the Installer, visit the Unity download archive. The archive page provides Unity Installer download links for all released versions of the Editor.

For additional information on installing the Editor using the Installer, see the 2018.3 version of the Unity Manual.

---

• 2018–12–19  Page amended with editorial review
• 2018–06–12 Page published with editorial review