Set up a workspace
Create a new workspace in Unity Version Control.
Read time 1 minuteLast updated 21 days ago
To work in Unity Version Control (UVCS), you need a repository. Inside your repository, you can create a workspace, which is a local copy of a project. Because a workspace is a local copy, you need to set up your workspace through the desktop application or the command line.
Note
If you work on Windows and you have a large amount of files, you might want to enable dynamic workspaces so that you don't have to download every file.
Create a workspace in the GUI
You can create a workspace when you create a repository, or you can create a workspace for an existing repository.- Select the repository dropdown menu.
- Select Open or create other workspace.
- Select Create a new workspace.
- Configure the workspace.
- Select a repository.
- Name the workspace.
- Select a location for the files.
- Select Create.
Create a workspace in the CLI
-
To create a new workspace, use the command:
cm workspace create>cm workspace create quakewk quake_path --repository=quake@localhost:6060Workspace quakewk has been correctly created -
Go to your newly created directory:
By default, the workspace uses the>cd quake_path>cm status/main@quake@localhost:6060 (cs:0 - head)branch.main -
To check the latest changeset on the branch, run :
cm status --head>cm status --headcs:573@quake@localhost:6060 -
Run to update to the latest changeset:
update
The command provides information about the copied files until you’re up to date with the latest changeset.cm update
Additional resources
- If you work on Windows, you might want to use a virtual filesystem and only download files you need, refer to the introduction to dynamic workspaces and information on how to enable dynamic workspaces.