Get started with Unity Version Control via the Unity Hub
You can add Unity Version Control (UVCS) to your Unity Editor 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’ve been added to a Unity organization or Unity Cloud project that uses DevOps, all you need to get started is a Unity ID. For detailed instructions, refer to Add projects from UVCS to your Hub.
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. Hover the link icon and select the link 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
Important: We are in the process of updating the Version Control experience. If you are not on the New experience, step 4 also prompts you to enter a UVCS organization name.
To create a new Unity Editor project in the Unity Hub and connect the repository to UVCS:
- Select New project.
- On the right side panel, enter a Project Name and select the Location.
- Check the Use Unity Version Control checkbox.
- Review the auto filled Repository Name, and Server location fields, and edit if you need to.
- Select Create project.
Add UVCS to an existing project
To enable UVCS for existing Unity Editor projects in the Hub:
- Open the contextual menu for the project.
- Select Use Unity Version Control.
- Review the auto filled UVCS fields, and edit if you need to.
- Select Connect to Version Control.
Add projects from UVCS to your Hub
If you've been added to a Unity organization or Unity Cloud project that contains Unity Editor projects, you can add those projects to the Hub:
Important: We are in the process of updating the Version Control experience. If you are not on the New experience, you can add repositories from all of the UVCS organizations you belong to.
- Select Add > Add from repository.
- Select the repository and then select Next.
- Select the Location where you want to download the repository, then select Next.
- Select the Editor version and platform and select Open.
- If you don't have a compatible Unity Editor version for the project, a dialog opens and prompts you to install one.
- The Unity Editor opens with the most recent project in the repository, which is added to the Hub.
Add encrypted repositories to your Hub
Important: We are in the process of updating the Version Control experience. If you are not on the New experience, you can add repositories from all encrypted UVCS organizations you belong to.
If you have been invited to an encrypted UVCS repository, you can add its contained projects to the Hub by following these steps:
- Ensure you have the encryption key needed to access the repository contents.
- If you haven't already, install the UVCS desktop client.
- Use the UVCS desktop client to download the repository contents to your local machine, entering the encryption key when prompted.
- In the Hub, select Add > Add project from disk, and select the project location.
- If the repository contains multiple projects, repeat step 4 for each project you want to work with.
Add repositories that don't contain 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:
- If you haven't already, install the UVCS desktop client.
- 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:
- Select Add > Add project from disk.
- Select 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:
- Select Add > Add project from disk.
- Select 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:
- If you haven't already, install the UVCS desktop client.
- In the UVCS desktop client, create a new workspace for the repository.
- In the Hub, select Add > Add project from disk, and select the project location in the new workspace.
Open your UVCS connected projects
When you open an Editor project that you enabled UVCS on, the Editor opens the project with the Unity Version Control tab open.
Note: If the Unity Version Control tab isn’t displayed, select Window > Unity Version Control to open the tab.
For information on how to use UVCS through the Unity Editor, refer to the Tutorials section.
Additional resources
- For information on the different UVCS features and functions available to you in the Unity Editor, refer to the VCS reference section.
- For information on how to set up, configure and manage Unity Version Control, refer to Configure Unity Version Control.
- To use Unity Version Control without the Unity engine, refer to Get started with Unity Version Control via the Desktop Client.
- For a tutorial on how to use UVCS with the Unity Hub, go to the Learn tutorial on how to use the Unity Hub.