Redmine

h1. HowTo simply keep Redmine in sync with GitHub

There are a lot of means out there, here is the simplest one I have found out:

1. Install the GitHub Hook plugin

* http://www.redmine.org/plugins/redmine_github_hook, it works with Redmine 1.2.1 too

2. In Redmine, go to Administration/Settings and click on the Repository tab

* Enable Git as SCM.

* Select "auto-fetch commits"

* Click on "Enable WS for repository management", generate an API key and copy it, we'll need it in a few minutes.

* Click "Save".

3. Now, you have to create a local repository on the machine Redmine is installed

* Use specifically the command @git clone --mirror [repo_url]@.

* Pay attention to the fact that Redmine needs read permissions on this folder.

* Then go into your projects settings, in the "repository tab". Select "Git" as SCM, and fill the +absolute+ path to the local repository you created just above.

4. Finally go to GitHub

* Select your repository and click on "Admin".

* Click on the "Service Hooks" tab and select Redmine in the list.

* Scroll up to fill needed information, don't forget the API Key we generated earlier. For instance, if your project url is http://redmine.mydomain.com/projects/my_project:

> Adress = http://redmine.mydomain.com

> Project = my_project

> API Key = the API key we got from Redmine

* Click "Update Settings" and you are done!