Get started with Unity Version Control via the Unity Hub

You can add Unity Version Control (UVCS) to your projects through the Unity Hub.

If you don't already have DevOps set up, then you get a free trial of the DevOps services when you enable Version Control through the Hub. You can also set up DevOps through your Unity Cloud Dashboard. For more information, refer to Get started with Unity DevOps.

Note: If you are an invitee to a Unity Version Control repository, you only need a Unity ID to begin working on it. For detailed instructions, refer to Add projects from UVCS to your Hub to get started.

View your projects in the Unity Hub

The second column on the Projects page of the Unity Hub shows whether each project has UVCS enabled:

  • The link icon means that the project uses UVCS. Select the link icon to view your repository in the Unity Cloud Dashboard.
  • The broken link icon means that the project doesn't use UVCS.

Enable UVCS for your projects

Create a project with UVCS

To create a new project in the Unity Hub with UVCS:

  1. Select New project.
  2. In the right side panel, set a Project Name and Location .
  3. Select the Use Unity Version Control checkbox.
  4. Check the auto filled Unity Version Control Organization, Repository Name, and Server location fields and edit them if necessary.
  5. Select Create project.

Add UVCS to an existing project

To enable UVCS for existing projects in the Hub:

  1. Open the contextual menu for the project.
  2. Select the Use Unity Version Control option in the dropdown menu.
  3. Check the auto filled UVCS fields and edit them if necessary.
  4. Select Connect to Version Control.

Add projects from UVCS to your Hub

If you've been invited to a UVCS repository containing Unity projects, you can add those projects to the Hub:

  1. Select Add > Add from repository.
  2. Select the repository and then click Next.
  3. Choose the Location where you want to download the repository, then click Next.
  4. Select the Editor version and platform and click Open.
    • If you don't have a compatible Unity Editor version for the project, a dialog opens and prompts you to install one.
  5. The Unity Editor opens with the most recent project in the repository, which is added to the Hub.

Add encrypted repositories to your Hub

If you have been invited to an encrypted UVCS repository, you can add its contained projects to the Hub by following these steps:

  1. Ensure you have the encryption key needed to access the repository contents.
  2. If you haven't already, install the UVCS desktop client.
  3. Use the UVCS desktop client to download the repository contents to your local machine, entering the encryption key when prompted.
  4. In the Hub, click Add, select Add project from disk, and select the project location.
  5. If the repository contains multiple projects, repeat step 4 for each project you want to work with.

Add projects not containing Unity projects to your local machine

A repository must contain the file ProjectSettings/ProjectVersion.txt to be recognized as a Unity project. If you have been invited to a UVCS repository that doesn't contain a Unity project in the root directory, you can still add it to your local machine by following these steps:

  1. If you haven't already, install the UVCS desktop client.
  2. Download the repository contents to your local machine using the UVCS desktop client.

If the repository contains Unity projects within subdirectories, you can add them to the Hub after following the previous steps by doing the following:

  1. Click Add and select Add project from Disk.
  2. Navigate to the project location within your local workspace inside the downloaded repository.

Add projects from already added repositories

If you have already added a repository to the Hub, you can add more projects from the same repository by following these steps:

  1. Click Add and select Add project from disk.
  2. Navigate to the project location in your local workspace within the already downloaded repository.

If you want to use different workspaces for different projects in the same repository, allowing you to work on different branches for each project, follow these steps:

  1. If you haven't already, install the UVCS desktop client.
  2. In the UVCS desktop client, create a new workspace for the repository.
  3. In the Hub, click Add, select Add project from disk, and choose the project location in the new workspace.

Open your UVCS projects

When you open a project that you enabled UVCS on, the Editor opens the project with the Unity Version Control window open.

Note: If the Unity Version Control tab isn’t displayed, select Window > Unity Version Control to open it.

For information on how to use UVCS through the Unity Editor, refer to the Tutorials section.

Additional resources