Skip to content

Setting up a Git server on Windows using Git for Windows and Win32_OpenSSH

Yanbing edited this page Sep 27, 2017 · 12 revisions

You need to download and install:

  • Install Win32_OpenSSH
  • Git for Windows, selecting the "Run Git and included Unix tools from the Windows Command Prompt" when prompted. This option will install a bin folder in Program Files\git that will be placed into your path thus taking possibly taking precedence over other tools.

On Server

  1. Set system environment variable for sshd to pick up the git commands

    $gitPath = Join-Path -Path $env:ProgramFiles -ChildPath "git\mingw64\bin"
    $machinePath = [Environment]::GetEnvironmentVariable('Path', 'MACHINE')
    [Environment]::SetEnvironmentVariable('Path', "$gitPath;$machinePath", 'Machine')
  2. Restart sshd so the changes to the Path environment variable can take effect.

  3. Create Windows users for all Git users.

  4. Create a central Git repository. Go to where you want to create a central repo, git clone --bare <source dir>. A directory with name <source dir>.git will be created. In it will be the .git contents of your source dir repo. for example:

    git clone --bare c:\git\newrepo.git

  5. If you already have user private and public keys, copy the user public key to C:\Users\{user}\.ssh\ and rename it to authorized_keys

On Client

  1. Set environment variable for git to use Win32_OpenSSH

    $env:GIT_SSH_COMMAND = '"C:\Program Files\OpenSSH\ssh.exe" -T'

  2. (Optional: for key based auth) For key based authentication to work, generate user private and public key. The generated public key need to copy to C:\Users{user}.ssh\authorizedkeys as indicated in step 5 on Server

    ssh-keygen.exe -t ed25519 -f c:\test\myprivatekey

  3. (Optional) Register the user private key for single sign on

    ssh-add.exe c:\test\myprivatekey

  4. To check out a repository:

**Note that git clone user@domain@servermachine:C:/test/myrepo.git does not work due to known issue. Work around it by following steps:

 # initialize a local repo folder
 git init mylocalrepo
 cd mylocalrepo
 # add the remote repro
 git remote add origin user@domain@servermachine:C:/test/myrepo.git
 # work around the known issue by launching powershell to run the git commands
 git config --local remote.origin.uploadpack "powershell git-upload-pack"
 git config --local remote.origin.receivepack "powershell git-receive-pack"
 git fetch origin
Clone this wiki locally