Adding repositories to a server project

You can add repositories to a server project to access the test assets available in the respective repository.

Before you begin

You must have completed the following tasks:
  • Added a project on HCL OneTest Server.
  • Been granted permission to access the repository.

About this task

As a project owner or a tester, you can add one or more repositories to your project. When you add a repository, the Git repository is cloned to your project. While adding a repository, you must provide the necessary authentication credentials that are set for the Git repository that you want to add to your project. For example, if the authentication type is SSH, then you must provide the Git URL, a deploy key, and a passphrase.

After you log in, from the Home page, you can add one or more repositories to your project by following these steps.


  1. Open your project.
  2. Click the Repositories tab.
  3. Click Add repository.

    The Add repository page is displayed.

  4. Enter the URL of the Git repository that you want to add to your project.
  5. Click the Expand icon to enter the required credentials based on any of the following authentication methods configured in the repository.
    To gain access to the repository, you must use any one of the authentication methods:
    Authentication method Credentials required
    • Deploy key
    • Passphrase
    • User name
    • Password
    • User name
    • Password
    • You must have defined the authentication type and set the authentication credentials in the Git repository.
    • If you use SSH to connect to your remote repository and HCL OneTest Server displays an Auth Fail exception while using the deliver changes option, you can resolve this exception error by regenerating your SSH keys by using the -m PEM option.
  6. Click Add.
    The Git repository is cloned on HCL OneTest Server.
    Note: Depending on the size of the repository you are cloning, it can take a few to several minutes to clone the repository.
  7. Optional: Repeat the steps to add another repository.

What to do next

You can perform the following actions on the repository that you added:
  • Update the authentication credentials if they are changed in the Git repository configuration.
  • Delete a repository if it is no longer required.
  • Refresh a repository to fetch and synchronize changes from the remote repository.
  • Configure a webhook to notify the server there is a push event in the remote repository.
  • Add a system model to the repository.