docs/content/migrations/importing-source-code/using-the-command-line-to-import-source-code/importing-a-subversion-repository.md

title, intro, versions, shortTitle

title	intro	versions	shortTitle
Importing a Subversion repository	You can import a repository from Subversion by converting the repository to Git, then pushing the Git repository to {% data variables.product.github %}.	fpt ghes ghec * * *	Subversion

Prerequisites

To follow these steps, you must use a macOS or Linux system and have the following tools installed:

• Subversion
• Git, including git-svn
• {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) (see AUTOTITLE)

Importing a Subversion repository

{% data reusables.migrations.create-empty-repo %} {% data reusables.migrations.confirm-git-installed %}

1. To confirm that git svn is available on your machine, run git svn --version.

   The output should be similar to git-svn version 2.40.0 (svn 1.14.2).

   If you can run git successfully but encounter an error when running git svn, you may need to install git svn separately. We recommend using Homebrew or the Ubuntu package registry, which include git-svn packages. {% data reusables.migrations.confirm-git-lfs-installed %}

2. Check out your Subversion repository.

   For example, to check out the Logisim open source project from Sourceforge, run svn checkout https://svn.code.sf.net/p/circuit/code/trunk.

3. Move into the directory for your Subversion repository.

4. To get a list of authors in your Subversion project and store the list in authors.txt, run the following script:

   svn log -q | grep -e '^r' | awk 'BEGIN { FS = "|" } ; { print $2" = "$2 }' | sed -E 's/^ *//' | sort | uniq > authors.txt
   

5. Update your authors.txt file, mapping the author name used in the Subversion repository to the name you want to use in your Git repository, with the following format:

   octocat = The Octocat <octocat@github.com>
   

6. To convert your Subversion repository to a Git repository, use git svn.

   • If your Subversion repository has a standard format, with “trunk”, “branches”, and “tags” folders, run git svn clone -s URL PATH/TO/DESTINATION --authors-file PATH/TO/AUTHORS.TXT, replacing URL with the URL of the Subversion repository, PATH/TO/DESTINATION with the path to the directory you want to clone the repository into, and PATH/TO/AUTHORS.TXT with the path to your authors.txt file.

     For example, to clone the Logisim project from Sourceforge into a directory called logisim, run git svn clone -s https://svn.code.sf.net/p/circuit/code logisim --authors-file path/to/authors.txt.

   • If your Subversion repository is non-standard, you can customize git svn to handle your repository. For more information, see git-svn in the Git documentation.

7. Git will check out each SVN revision and turn the revision into a Git commit. If your repository has many files or a lot of history, this process will take a long time.

   For large repositories, the command may freeze. If so, you can begin where you ended by terminating the command with Ctrl+C, moving to your new directory, and then running git svn fetch. {% data reusables.migrations.move-into-git-repo-directory %} {% data reusables.migrations.add-github-repo-as-remote %} {% data reusables.migrations.push-to-github %}

{% ifversion fpt or ghec %}

Further reading

• AUTOTITLE {% endif %}