Git at Apache

This is a temporary holding place for working on writable Git repositories. This is a work in progress and may disappear.

Please contact the infrastructure-dev@apache.org mailing list if you have comments or suggestions regarding this service.

Repository Checkout

For now the repository URLs are all of the form:

https://git-wip-us.apache.org/repos/asf/reponame.git

To clone a repository:

# Non Committers
$ git clone http://git-wip-us.apache.org/repos/asf/reponame.git

# Committers
$ git clone https://git-wip-us.apache.org/repos/asf/reponame.git

Committers: Getting Started

First things first, you'll want to set up your name and email that will be used by git when you make commits:

$ git config --global user.name "My Name Here"
$ git config --global user.email myusername@apache.org

If you're a long time GitHub user you can instead set these configuration variables on a per repository basis like such:

$ git config user.name "My Name Here"
$ git config user.email myusername@apache.org

You can also add your apache.org email address to your GitHub account so that your Gravatar and user account are linked to from the Apache mirrors on GitHub.

To push to a repository you need to setup a ~/.netrc file that contains your user credentials:

$ (umask 0277; cat >> ~/.netrc <<EOF)
machine git-wip-us.apache.org
login username
password mypassword
EOF
chmod 0600 ~/.netrc

Alternatively you can list your username in the Git repository URL but this will require that you type your password for every fetch and push. You can do this by cloning a URL like:

$ git clone https://username@git-wip-us.apache.org/repos/asf/reponame.git

While its possible to list your password in the URL this is highly discouraged as it obviously leaves your password in plain text in the shell history.

Windows Users

You can use git-gui as part of the msysgit package.

Instead of setting up a ~/.netrc file you need to:

  1. Set up a %HOME% environment pointing to C:\Users\yourloginname\
  2. Create a _netrc file in %HOME%\_netrc with this text all on one line: machine git-wip-us.apache.org login username password mypassword

Ongoing improvements

Improvements to Git support at Apache are being discussed on the infrastructure dev list. This list is open to everyone and is publicly archived. You can subscribe to this mailing list by sending a message to infrastructure-dev-subscribe@apache.org