Importing code from an existing project
This page describes the methods you can use to import code from existing projects into Bitbucket Server. When creating a new repository, you can import code from an existing project into Bitbucket Server using either the terminal or the web interface.
If you're using Bitbucket Cloud, take a look at our Import or convert code from an existing tool page for more information.
On this page
Import code using the web interface
Introduced in Bitbucket Server 4.9, you can import code and its version/branching history into Bitbucket Server from existing Git projects hosted with Bitbucket Cloud, GitHub, GitHub Enterprise, or a standalone Git repository using the web interface.
To start importing code
- While viewing a project within Bitbucket Server click Import repository in the sidebar.
- Select a source to import code from, provide the required information, then click Connect.
- For Bitbucket Cloud, include the Username and App password for the account to import from, and ensure read access for team, project, and repository is enabled.
- For GitHub, include the Username and Personal access token for the account to import from, and ensure the repo and read:org scopes are enabled.
- For GitHub Enterprise, provide the Server URL, Username, and Personal access token for the account to import from, and ensure the repo and read:org scopes are enabled.
- For a single Git repository, provide the Clone URL, and Username and Password (if required).
- For Bitbucket Cloud, include the Username and App password for the account to import from, and ensure read access for team, project, and repository is enabled.
- Choose which repositories to import.
- All repositories imports all the repositories owned by the account provided.
- Select repositories allows you choose specific repositories to import.
- Click Import.
Once importing completes, you can refresh the project page to see the imported repositories.
Import code using the terminal
Import code from an existing project using the terminal by first cloning the repository to your local system and then pushing to an empty Bitbucket Server repository.
Import an existing, unversioned code project into Bitbucket Server
If you have code on your local machine that is not under source control, you can put it under source control and import it into Bitbucket Server.
Assuming you have Git installed on your local machine, then:
- Locally, change to the root directory of your existing source.
Initialize the project by running the following commands in the terminal:
git init git add --all git commit -m "Initial Commit"- Log into Bitbucket Server and create a new repository.
- Locate the clone URL in the nav panel on the left (for example: https://username@your.bitbucket.domain:7999 /yourproject/repo.git).
Push your files to the repository by running the following commands in the terminal (change the URL accordingly):
git remote add origin https://username@your.bitbucket.domain:7999/yourproject/repo.git git push -u origin master- Done! Your repository is now available in Bitbucket Server.
Import an existing Git project into Bitbucket Server
You can import your existing Git repository into an empty repository in Bitbucket Server. When you do this, Bitbucket Server maintains your commit history.
Check out the repository from your existing Git host. Use the --bare parameter:
git clone --bare https://username@bitbucket.org/exampleuser/old-repository.gitLog into Bitbucket Server and create a new repository (we've called it
repo.gitin this example).Locate the clone URL in the nav panel on the left (for example: https://username@your.bitbucket.domain:7999 /yourproject/repo.git).
Add Bitbucket Server as another remote in your local repository:
cd old-repository git remote add bitbucket https://username@your.bitbucket.domain:7999/yourproject/repo.gitPush all branches and tags to the new repository in Bitbucket Server:
git push --all bitbucket git push --tags bitbucketRemove your temporary local repository:
cd .. rm -rf old-repository
Mirror an existing Git repository
You can mirror an existing repository into a repository hosted in Bitbucket Server.
Check out the repository from your existing Git host. Use the --mirror parameter:
git clone --mirror https://username@bitbucket.org/exampleuser/repository-to-mirror.gitLog into Bitbucket Server and create a new repository (we've called it
repo.gitin this example).Locate the clone URL in the nav panel on the left (for example:
https://username@your.bitbucket.domain:7999/yourproject/repo.git).Add Bitbucket Server as another remote in your local repository:
git remote add bitbucket https://username@your.bitbucket.domain:7999/yourproject/repo.gitThen push all branches and tags to Bitbucket Server:
git push --all bitbucket git push --tags bitbucket- Use
git fetch --prune origin('–prune' will remove any branches that no longer exist in the remote) followed by thegit pushcommands from step 5 to update the Bitbucket Server mirror with new changes from the upstream repository.