TWiki> Main Web>GitSetup (2017-10-16, bmgraves)EditAttach

Creating a Git Repo

Git repositories allow for many types of workflows, centralized or decentralized. Before creating your repo, decide which steps to follow:


Create A Local Repository

If you will be working primarily on a local machine, you may simply create a git repo by using cd to change to the directory you wish to place under version control, then typing:

git init

To initialize a git repo in that directory. From then on, you can run git commands in that directory.

Create A Remote Repository

If you will be working with your code primarily on patas, you will likely want to create your initial repository there.

  1. ssh to
  2. cd to the directory you wish to place under version control
  3. type "git init" in this directory.

Cloning the Remote Repository

If you wish to maintain a local copy of your code, you can clone the repository from patas by doing the following:

  1. create and cd into the directory you want to store the copy of the repository in
  2. type:


    for instance, if your username is "clmastudent" and the repo on patas is at ~/mycode, and you are already in the desired directory to store the copy ("."), you would type:

    git clone ssh:// .
  3. After entering your ssh password, you should have a copy of the entire repo in whichever directory you chose to clone it to.

Create a Shared Repository on Patas

If you will be working with a group, using Patas as a centrally-located server to coordinate your checkins is a good idea, but takes some setting up.

  1. You will need to send a request to requesting that a group be created for the patas account names in your group. This will allow your group members read/write access to your files, without making them readable to everyone.
    1. You may also wish to request a directory be made for your group in the /workspace directory on the server. This space is intended specifically for shared projects.
  2. Once inside the desired directory, you will need to type:
    git init --shared=group
    this will create a git repo in which all group members are able to check in code ("Push" to, in Git terms)

If you already have a repository that wasn't created with --shared=group, you can convert it by doing the following:

  1. Edit the repository's "config" file (found in the main directory of the repository if it's bare, or in the .git folder if it's non-bare.)
  2. Add a line under [core] with "sharedRepository=true"
  3. Run "chmod -R g+w" on the repository's main directory.

"Bare" repositories

By default, the shared repository has a working copy just like one on your local machine. git will complain if you do any remote operations that might make this working copy go out of sync, such as "git push origin master," with a message like the following:

remote: error: By default, updating the current branch in a non-bare repository
remote: error: is denied, because it will make the index and work tree inconsistent
remote: error: with what you pushed, and will require 'git reset --hard' to match
remote: error: the work tree to HEAD.

The solution is to make your shared repository a "bare" repository, with no working copy. The git FAQ has a good example of how to convert a non-"bare" repository to a "bare" one. For more information, see the description of "--bare" in the git-clone manpage or this stackoverflow thread.

These instructions seem to sometimes convert a shared repository into a non-shared one, causing only one group member to be able to push; if you have this problem, you can correct it with the instructions at the end of the section above.

Topic attachments
I Attachment Action Size Date Who Comment
pngpng Git_Flowchart.png manage 42.7 K 2011-05-04 - 18:42 UnknownUser Flowchart for which type of git repo to create.
Topic revision: r8 - 2017-10-16 - 20:12:32 - bmgraves

This site is powered by the TWiki collaboration platformCopyright & by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Privacy Statement Terms & Conditions