# Import a workspace from a Git repository

In Datalore, you can create workspaces from notebooks and files stored in Git repositories. You can import both repositories with Jupyter-compatible notebooks and repositories with workspaces previously exported or backed up from Datalore.

Workspace import works as follows:

* The new workspace in Datalore gets its name from the imported Git repository. You can [rename the workspace](datalore-workspaces.html#edit-a-workspace) later in workspace settings.

* All the imported `.ipynb` files are added to the ![Book](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/book.svg)Notebooks section.

* If a file is stored in a folder that shares the same name as an imported notebook, it will be imported as part of that notebook.

* All other files are added as workspace files. They are available in the ![Document](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/document.svg)Data section of the new workspace.

* The folder structure of files imported as notebook files and workspace files is preserved.

Supported Git providers
: Datalore supports workspace import from GitHub, GitLab, and other Git providers that use standard Git commands and API.
:
:
:
: Self-hosted providers are supported too, as long as they can accept SSH connections and do not use any non-standard configuration.
:
:
:
: > **Note:**
: > Datalore allows importing repositories of up to 100 MB.
: >
: >
: >
: > In Datalore On-Premises, you can adjust the limit using the [GIT_REPOSITORY_SIZE_LIMIT parameter](server-configuration.html#git-repository-size-limit).

Procedure: Import a workspace

1. On the Home page, click ![Plus](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/plus.svg)New workspace at the bottom left.

2. In the New workspace dialog, switch to the From repository tab.

![Creating a new workspace from a Git repository](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/workspace-import-git.png)

3. In Repository URL, enter the URL of your Git repository.

> **Note:**
> If you are importing a public repository, you can enter an HTTPS URL.
>
>
>
> If you are importing a private repository or you want to use this repository to [back up the new workspace](git-backup.html), you must use an SSH URL.

4. Configure the connection depending on the URL you provided:

HTTPS URL:

1.  (Optional) In Branch, select the branch to import notebooks and files from.

2.  (Optional) In Base directory, enter the name of the directory to import notebooks and files from. If left empty, the repository root is used.

> **Note:**
> When you import a workspace using an HTTPS URL, you cannot enable workspace backups to the same repository. To set up backups, use an SSH URL or [add a repository connection](git-backup.html) later.

SSH URL:

1. Click ![Plus](https://resources.jetbrains.com.cn/help/img/datalore/2026.3/plus.svg)Add SSH key.

2.

Paste the SSH private key you want to use for the connection and click Go to next step.

> **Tip:**
> If you do not have a key, you can generate a new one by clicking generate. Then copy the SSH public key from the dialog and add it to your Git provider.

3. Click Add key.

4.  (Optional) In Branch, select the branch to import notebooks and files from.

5.  (Optional) In Base directory, enter the name of the directory to import notebooks and files from. If left empty, the repository root is used.

6.  (Optional) To set up this repository connection for [workspace backups](git-backup.html), enable Use this repository to back up the new workspace.

7.  (Optional) If you want to back up notebooks without outputs, enable Exclude cell outputs from backup.

8.  (Optional) In Backup file structure, select how you want the notebooks and files to be stored in the backup.

5. Click Create workspace.

## Next steps

* [Add files](add-files-to-a-workspace.html) to your new workspace

* Create connections to [databases](configure-a-database-connection.html) and [cloud storage providers](use-s3-buckets.html)

* [Edit code in notebooks](code-cells.html)

* [Collaborate with your team](share-workspace.html)

* [Create workspace backups](git-backup.html#back-up-workspace)

* [Manage workspace settings](datalore-workspaces.html#edit-a-workspace)