The local repository
It doesn’t really matter how the local repository is set up, but for the sake of argument, let’s suppose you’re starting one from scratch.
$ mkdir website && cd website
$ git init
Initialized empty Git repository in /home/ams/website/.git/
$ echo 'Hello, world!' > index.html
$ git add index.html
$ git commit -q -m "The humble beginnings of my web site."
Anyway, however you got there, you have a repository whose contents you want to turn into a web site.
The remote repository
I assume that the web site will live on a server to which you have ssh access, and that things are set up so that you can ssh to it without having to type a password (i.e., that your public key is in
~/.ssh/authorized_keys and you are running
On the server, we create a new repository to mirror the local one.
$ mkdir website.git && cd website.git
$ git init --bare
Initialized empty Git repository in /home/ams/website.git/
Then we define (and enable) a post-receive hook that checks out the latest tree into the web server’s DocumentRoot (this directory must exist; Git will not create it for you):
$ mkdir /var/www/www.example.org
$ cat > hooks/post-receive
GIT_WORK_TREE=/var/www/www.example.org git checkout -f
$ chmod +x hooks/post-receive
Note: earlier versions of this howto depended on setting the git config variables core.worktree to the target directory, core.bare to false, and receive.denycurrentbranch to ignore. But these changes are not needed if you use GIT_WORK_TREE (which didn’t work when I first wrote the howto), and the remote repository can remain bare.
Back on the workstation, we define a name for the remote mirror, and then mirror to it, creating a new “
master” branch there.
$ git remote add web ssh://server.example.org/home/ams/website.git
$ git push web +master:refs/heads/master
On the server,
/var/www/www.example.org should now contain a copy of your files, independent of any
The update process
Nothing could be simpler. In the local repository, just run
$ git push web
This will transfer any new commits to the remote repository, where the
post-receive hook will immediately update the
DocumentRoot for you.
(This is more convenient than defining your workstation as a remote on the server, and running “
git pull” by hand or from a cron job, and it doesn’t require your workstation to be accessible by ssh.)