Using Git within a Workspace with a Linux VM

Users can create Git repositories completely private and local to their workspace to facilitate collaborative code development and document version control. This is provided through the use of the Open Source tool ‘Gitea’. Full documentation on Gitea can be found at:

Creating a repository and managing files, branches and pull requests can all be achieved using the Gitea web portal. To access the web portal, when within a Linux VM, open the browser and navigate to:


Below you can see a screenshot of the Gitea web portal home page within a demo workspace environment with a URL, for example:

In this example, my-workspace-name is the name of the workspace and is the domain of the workspace.

The full Gitea web portal address in this case is

There can only be one Organization and that Organization has the name of the workspace.

All members of the workspace will be members of the Organization and will have the facility to create repositories, clone repositories and work with Gitea as they would expect. To create a new repository, from the Organization page, select ‘New Repository’.

When doing so, the user has a number of options. For example, the repository could be created as a template or be based on a template.

Upon creation of the repository, instructions are provided on how to clone the repository. This requires terminal access. Open a Linux terminal and type:

git clone <repo>

where <repo> is the long form name of the repo as provided by the Gitea UI. You can copy the repo name directly from the UI use the ‘copy url’ button as shown below.

It is recommended for performance purposes the user clones this repo in a dedicated directory within their home file environment, for example: /home/scott.russell_7b2alc0


mkdir ./git

cd git

git clone

At this stage, the repo is completely empty. At least a single file must be added to the cloned repo. Users of Git will be familiar with the CLI required to commit a file to the master branch.

git add <file>

git commit -m ‘<comment>’

git push origin master

On completion of these steps the user can work with files within the repo using the Gitea UI or the expected Git CLI commands.

Full documentation on Gitea can be found at Note that repos cloned into Linux VM home directories will not be accessible from Built-in Apps such as RStudio or Jupyter Notebook. To use them from those apps, the user must clone repos into an area within the /files shared environment in the workspace. Should this be required, it is recommended that individual users clone repos into their own appropriately named subdirectory of /files. Please be aware that performance of Gitea may degrade when using large repos on the shared file system.

Updated on November 3, 2022

Was this article helpful?

Related Articles

Not the solution you were looking for?
Click the link below to submit a support ticket