User Settings for Projects

From within Projects, users have the ability to connect to a remote repository such as GitHub and GitLab. Users can also utilize fetch, push, pull, and clone operations on a repository to sync a local copy of a Project with the latest changes made by other collaborators.

A set of valid credentials is required to communicate with any remote repository.

 See also Git Integration for Projects.

Setup Access Tokens

Users must setup an access token for GitLab or GitHub for git integration to work.

1. Click the menu icon next to the right of the Itential logo at the top of the application.

2. Click the username in the menu that opens. The User Settings dialog will display.

   Figure 1: Access User Settings
   

3. Input an email address. The email address must consist of a username and a domain. Standard formats such as name@example.com and firstname.lastname@example.com are accepted.

4. Paste the user access token into its respective field (i.e., GitHub, GitLab).

5. Click Save to retain the token settings.

   Figure 2: User Settings
   

Connect to Existing Repository

If you attempt to connect to an existing repository and no tokens are available, an alert message displays under the Remote Connection fieldname. Click "See User Settings" to open the User Settings dialog and proceed to enter the necessary credentials. Click Save to finalize.

Figure 3: Connect to Existing Repository

Figure 4: User Settings in Existing Repository

Related Reading

• GitHub
• GitLab