Skip to content

Commit

Permalink
Update splitting-a-subfolder-out-into-a-new-repository.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Weera1234 authored Jan 30, 2025
1 parent cd058f2 commit 49a0827
Showing 1 changed file with 1 addition and 90 deletions.
Original file line number Diff line number Diff line change
@@ -1,90 +1 @@
---
title: Splitting a subfolder out into a new repository
redirect_from:
- /articles/splitting-a-subpath-out-into-a-new-repository
- /articles/splitting-a-subfolder-out-into-a-new-repository
- /github/using-git/splitting-a-subfolder-out-into-a-new-repository
- /github/getting-started-with-github/splitting-a-subfolder-out-into-a-new-repository
- /github/getting-started-with-github/using-git/splitting-a-subfolder-out-into-a-new-repository
intro: You can turn a folder within a Git repository into a brand new repository.
versions:
fpt: '*'
ghes: '*'
ghae: '*'
ghec: '*'
shortTitle: Splitting a subfolder
---
If you create a new clone of the repository, you won't lose any of your Git history or changes when you split a folder into a separate repository.

{% data reusables.command_line.open_the_multi_os_terminal %}

2. Change the current working directory to the location where you want to create your new repository.

4. Clone the repository that contains the subfolder.
```shell
$ git clone https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY-NAME
```

4. Change the current working directory to your cloned repository.
```shell
$ cd REPOSITORY-NAME
```

5. To filter out the subfolder from the rest of the files in the repository, install [`git-filter-repo`](https://github.com/newren/git-filter-repo), then run `git filter-repo` with the following arguments.
- `FOLDER-NAME`: The folder within your project where you'd like to create a separate repository.

{% windows %}

{% tip %}

**Tip:** Windows users should use `/` to delimit folders.

{% endtip %}

{% endwindows %}

```shell
$ git filter-repo --path FOLDER-NAME/
# Filter the specified branch in your directory and remove empty commits
> Rewrite 48dc599c80e20527ed902928085e7861e6b3cbe6 (89/89)
> Ref 'refs/heads/BRANCH-NAME' was rewritten
```

The repository should now only contain the files that were in your subfolder(s).

6. [Create a new repository](/repositories/creating-and-managing-repositories/creating-a-new-repository) on {% data variables.product.product_name %}.

7. At the top of your new repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}'s Quick Setup page, click {% octicon "clippy" aria-label="The copy to clipboard icon" %} to copy the remote repository URL.

![Copy remote repository URL field](/assets/images/help/repository/copy-remote-repository-url-quick-setup.png)

{% tip %}

**Tip:** For information on the difference between HTTPS and SSH URLs, see "[About remote repositories](/get-started/getting-started-with-git/about-remote-repositories)."

{% endtip %}

8. Check the existing remote name for your repository. For example, `origin` or `upstream` are two common choices.
```shell
$ git remote -v
> origin https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY-NAME.git (fetch)
> origin https://{% data variables.command_line.codeblock %}/USERNAME/REPOSITORY-NAME.git (push)
```

9. Set up a new remote URL for your new repository using the existing remote name and the remote repository URL you copied in step 7.
```shell
git remote set-url origin https://{% data variables.command_line.codeblock %}/USERNAME/NEW-REPOSITORY-NAME.git
```

10. Verify that the remote URL has changed with your new repository name.
```shell
$ git remote -v
# Verify new remote URL
> origin https://{% data variables.command_line.codeblock %}/USERNAME/NEW-REPOSITORY-NAME.git (fetch)
> origin https://{% data variables.command_line.codeblock %}/USERNAME/NEW-REPOSITORY-NAME.git (push)
```

11. Push your changes to the new repository on {% data variables.product.product_name %}.
```shell
git push -u origin BRANCH-NAME
```
https://github.com/actions/.github.git

2 comments on commit 49a0827

@minako2024

This comment was marked as spam.

@majidrazaee2

This comment was marked as spam.

Please sign in to comment.