It seems like everybody uses git for source control nowadays. Heck, Microsoft is using git instead of its own TFVC. Although I’ve been using GitHub for open source projects for years now, most of my day is still spent in TFS. I finally got the green-light to move one fairly large project from TFS with TFVC to VSTS with git, this post is about my experience during the move.


  • Migrate one repository with few branches from TFS 2017 to VSTS
  • Permanent move; no need to keep TFS and VSTS in sync after conversion
  • Migrate history for all branches being moved

The first two requirements are quite easy to achieve but the last one proved to be tricky. Luckily, we have git-tfs.


git-tfs is a two-way bridge between TFS and git. It essentially converts changesets to commits and vice-versa. For the purpose of this article, I’m going to focus on TFS > git direction only.


  • Install git
  • Install a minimal version of Visual Studio 2015. VS2017 is not supported by git-tfs yet.
  • Install git-tfs. You can use Chocolatey or download the binaries from the releases page
  • As of writing of this post, version v0.29.0 is the current version. Note that I was not able to use this version as it was failing to load the TFS assemblies from my installation. I had to use v0.28.0.
    • Update - V0.29.0 worked for me when I unblocked all the files by using following powershell
      gci c:\lpains\git-tfs | Unblock-File
  • Since I downloaded the binaries and dropped them in an arbitrary folder, I had to add git-tfs folder to my path variable.
set PATH=%PATH%;c:\lpains\git-tfs


“Clone” your parent branch from TFS. This will create a git repository with all commits and correct branch and relations from TFS. You may want to provide a .gitignore or a user map file to further optimize the clone to your needs. For more options, check clone command documentation.

mkdir c:\lpains\Project
cd c:\lpains\Project
git tfs clone https://tfs/tfs/DefaultCollection $/Project/Path/To/ParentBranch --branches=all

Coffe time This is going to take a while so…

git-tfs suggests cleaning git-tfs metadata. This is optional but will leave you with a cleaner repository.

git filter-branch -f --msg-filter "sed 's/^git-tfs-id:.*$//g'" -- --all

Delete old branches by deleting the .git/refs/original folder.

In order to push your repository to VSTS, you will need to add an origin reference to your newly created git repository

git remote add origin https://MySubscription.visualstudio.com/MyProject/_git/Repository

Lastly, we push the git repository to VSTS. I had one commit in my remote repo (added readme.md file) and tried to perform a pull. That caused a refusing to merge unrelated histories error. In this case, I do want to merge the histories so I repeated the pull command with --allow-unrelated-histories flag

git pull origin --allow-unrelated-histories
git push --all origin


Git-tfs is great. Even though the project maintenance seems to have slowed considerably, I still highly recommend the tool if you are moving from TFVC to git. Feel free to post your experience in the comments section below.



When developing a small Xamarin forms app I wanted the android emulator to connect to an intranet identity provider. That didn’t work. The id server was using an SSL certificate issued by an untrusted CA. Here’s what I did to get it working.

First, you will need the CA certificate so android can trust the SSL cert. If you don’t have the cert, you can export it using Chrome on mac or Chrome on windows:

Export Certificate Exporting certificate using chrome

Next, push the .cer to the emulator using adb push command. Note that even though I’m pushing the cert to the sdcard it actually shows in a different location. I’m not sure why my emulator is doing that but I’ve seen others that work just fine. Just make sure to search in all folders when installing the cert in the emulator.

adb push path_to_cert\ca_cert_file.cer /sdcard/ca_cert_file.cer

Before installing the certificate, you will need to enable device lockscreen security. Finally, install the certificate using Settings app:

Import Certificate Importing certificate to Android Emulator

After import, you can check your certs in User credentials under Encryption & credentials and more importantly, navigate to the SSL site without errors.