Git Quick Start Guide

This page is to capture issues raised on IRC by other committers and users, so we don't lose that info while it gets added to official documentation. The steps here should mirror the more detailed instructions at the below url:

- https://docs.freebsd.org/en/articles/committers-guide/#git-primer

Pick an empty directory, let's call it ~/src/ports for example. A full clone takes about 900MiB space.

# pick any GIT_PORTS_DIR you want
export GIT_PORTS_DIR=~/src/ports
# this step can take a while, in future it will be much quicker
git clone -o freebsd -b main https://git.freebsd.org/ports.git $GIT_PORTS_DIR
cd $GIT_PORTS_DIR
# now we add in your push URL, and fetching the old SVN notes so you can
# look for svn revisions in your git log
git remote set-url --push freebsd ssh://git@gitrepo.freebsd.org/ports.git
git config --add remote.freebsd.fetch "+refs/notes/*:refs/notes/*"

You'll now need to add your username and user id, exactly as they are on freefall:

...