Git on Windows: Creating a network shared central repository.
I was doing some basic Git training for a customer this past week and they asked about how to setup their repositories to push/pull from a network share. I thought it would be simple and we spent a few minutes in class trying to accomplish it. We stopped trying in class and I took it as a homework assignment to figure it out before the next lesson. It was a little bit of a struggle to get this working for me, so I thought I?d throw this out there for any windows developers trying to do a similar thing.
I tend to prefer the command line to any of the git UI tools (except when visualizing history, and diffing files). In this post I?m going to show how you can do it through a command line, but I?ll also show how you can do it with git gui which, in this case, is a few less steps.
How to push a local repository up to an (un-initialized) remote windows share.
Command Line:
I tend to run git within PowerShell, however the following set of commands cannot be run within the PowerShell prompt. If you figure out a way, I?d love to hear about it. And since I use the PowerShell prompt, I?m not sure how this would play out with the bash command.
Open a command prompt (cmd.exe) and follow the below steps to create a remote windows repository share.
CD into the context of your local repository. Say my repo was at ?C:\Code\MyGitRepo1?.
cd C:\Code\MyGitRepo1
Next we?re going to change our current directory to the remote share location.
Something I learned during this process is that cmd.exe doesn?t allow you to ?cd? into a UNC network share path.
To get around not being allowed to ?cd? into a UNC network share we?ll use the pushd command. The reason this works is because it is actually going to map a network drive to the network share location.
Now that we?re in the remote location we can create a bare git repository.
mkdir MyGitRepo1
cd MyGitRepo1
git init –bare
Your remote empty repository has now been created. Let?s go back to our local repository
popd
popd will ?CD? back to the previous location (?C:\Code\MyGitRepo1?) and also remove the network share the pushd command created above.
So we should be back in the context of our local git repo.
C:\Code\MyGitRepo1\ >
Now all we need to do is add the newly created remote bare repository to our local repo and push our code up.
Notice the direction of the slashes in the path below (this stumped me for a bit)
git remote add origin //remoteServer/git/Share/Folder/Path/MyGitRepo1
git push origin master
Kind of a pain at the command prompt really, but it?s not something that?s done all that often.
Using Git gui instead:
Open up the GUI
git gui
Click the [Remote->Add] menu option to bring up the ?Add Remote? dialog.
Enter the name for your remote ?origin? is pretty typical for the central repository, but you can call this whatever you want. Then type the remote location. Notice the direction of the slashes.
Now you should be good to go.
Hope this helps someone else, and if anyone knows of a better/easier way I?d love to hear it.
This is exaclty what I’ve been looking for last several days! Many thanks for sharing this 🙂
I can’t recommend this, because we used this for a while and at that time we were little suspicious about performance. Then we decided install linux server into virtual environment and now work with central repository on that linux is much more faster then on share folder.
Also we have some issues with authorization thru Active Directory to that shared folder.
Thanks for the update. I’ve not actually used this technique in the wild. What perf issues were you noticing? Were they around push/pulling from the repo? Or did the local repo run slow for some reason?
Yes, problem was push/pull from central repo.
I was able to do this in Powershell without any problem. The only thing that I can imagine is different was that I have Posh-Git installed. It shouldn’t have had an impact though.
I have posh-git installed also, however when I try the “git init –bare” command it doesn’t work within powershellD:CodeGitTest [master]> pushd \RemoteShareD$tempGitRepo
Microsoft.PowerShell.CoreFileSystem::\RemoteShareD$tempGitRepo> git init –bare
and the output I get is
‘\RemoteShareD$tempGitRepo’
CMD.EXE was started with the above path as the current directory.
UNC paths are not supported. Defaulting to Windows directory.
Initialized empty Git repository in C:/Windows/.git/
Thoughts?
You can skip the init –bare step if you use the correct git workflow.
A detailed post is here:
http://tendrid.blogspot.com/2011/03/svn-users-tale-of-git-learning-curve.html
The easy thing to learn and remember is that git discourages working in the master branch. Branch master to another name. Then you can git push to a new directory without init first.
You can skip the init –bare step if you use the correct git workflow.
A detailed post is here:
http://tendrid.blogspot.com/2011/03/svn-users-tale-of-git-learning-curve.html
The easy thing to learn and remember is that git discourages working in the master branch. Branch master to another name. Then you can git push to a new directory without init first.
You do not need to fiddle with pushd, just spefify the desired UNC path of your bare repo as an argument to git:
git init –bare //computer/share/path/repo
It will even create the “repo” directory for your if it does not exist at //computer/share/path/
Just in case, git –version prints
git version 1.7.6.msysgit.0
on my system.