Skip to main content
Paradime imports a repository using any valid SSH Git URL that points to it. The steps below are the same for every provider; only the final step of adding the deploy key differs.
You must use the git@... or ssh:... version of your git URL, not the https://... version. Paradime uses the SSH protocol to clone repositories, so it cannot clone repos supplied with the HTTP protocol.

​
Import a repository

  1. In Paradime, go to Settings → Workspace.
  2. In the Git Connections section, click Edit Repository.
  3. Paste your repository’s SSH URL into the Repository SSH URL field.
  4. Copy the Deploy Key that Paradime generates.
  5. Add the Deploy Key to your Git provider with read and write access (see the provider guide below).
  6. Back in Paradime, save the connection using one of the two options below.
Paradime generates a Deploy Key that must be added to your Git provider’s repository configuration. This Deploy Key needs read and write access.
The Deploy Key is stable. It stays the same when you refresh or reopen the page, so you can copy it, install it in your provider, and come back later without the key changing.

​
Deploy Key controls: Refetch and Regenerate

Two controls sit next to the Deploy Key:
  • Refetch copies the existing Deploy Key again. It does not change the key, so anything you’ve already installed in your Git provider keeps working. Use it when you need to grab the same key a second time (for example, to hand it to a colleague).
  • Regenerate creates a brand new Deploy Key and replaces the old one. Because it’s a destructive action, Paradime asks you to confirm before regenerating.
Regenerating invalidates the previously generated Deploy Key. Any copy of the old key that’s already installed in your Git provider stops working immediately. If you regenerate, you must install the new key in your Git provider, otherwise the connection will fail.

​
Save the connection

When you save, you can either test the connection right away or save it now and verify later:

Test & Save

Paradime validates the connection and clones the repository immediately, then marks it Verified. Use this when the Deploy Key is already installed in your Git provider.

Save without testing

Paradime saves the repository without cloning it and marks the connection Pending verification. Use this when you can’t install the Deploy Key yet (for example, someone else manages the provider). You can verify it later.

​
Verify a pending connection

A connection saved with Save without testing stays in a Pending verification state, shown with an amber badge and banner in the Git Connections section.
While a connection is pending, the Code IDE, Bolt, and DinoAI stay inactive. Verify the connection to activate them.
Once the Deploy Key is installed in your Git provider:
  1. Go to Settings → Workspace.
  2. In the Git Connections section, click Verify connection.
  3. Paradime checks the connection and, on success, clones the repository and promotes it to Verified. Code IDE, Bolt, and DinoAI activate.
If verification fails (for example, the Deploy Key isn’t installed yet), the connection stays pending and Paradime shows an error. Install the key and try again.

​
Provider guides

Each provider has its own guide for adding the Paradime deploy key, available under Integrations:

GitHub

Add a deploy key to a GitHub repository.

GitLab

Add a deploy key to a GitLab repository.

BitBucket

Add a deploy key to a BitBucket Cloud or Server repository.

Azure DevOps

Add an SSH key to an Azure DevOps repository.
Need to update your Git repository? See Update connected git repository.

Related topics

Git RepositoriesConnecting a repository asynchronouslyConnect a GitHub repositoryLookerUpdate connected git repository