Redmine

h1. Gitosis Plugin

A Redmine plugin which manages your gitosis configuration based on your projects and memberships in Redmine. Includes Public Key management views (extracted from "*Planio Redmine Hosting*":http://plan.io/redmine-hosting/). 

h2. Features

* Updates your Gitosis config (create repos, add keys, add access privileges)

* Allows users to upload public keys

h2. Getting the plugin

Please head over to "GitHub":http://github.com/rocket-rentals/redmine-gitosis to fetch the latest version.

h2. Release notes

This plugin is provided as is and experimental. It works great in production for "Planio":http://plan.io, but we don’t guarantee it will work for you. 

h2. Requirements

Note: this is probably not a complete list

* ruby inifiles 

<pre>

gem install inifile

</pre>

* ruby ssh2 library

for Debian/Ubuntu users:

<pre>

apt-get install libnet-ssh2-ruby1.8

</pre>

or 

<pre>

gem install net-ssh

</pre>

* ruby lockfile library

for Debian/Ubuntu users:

<pre>

apt-get install liblockfile-ruby

</pre>

or

<pre>

gem install lockfile

</pre>

h2. Installation notes

* make sure the plugin folder is named redmine_gitosis and not redmine-gitosis (note "_" vs "-")

* you must setup a key with gitosis-admin write rights and copy it to /path/to/redmine/vendor/plugins/redmine_gitosis/extra/ssh/private_key

** for some misterious reason I had to copy the key in ~/.ssh/id for the user running passenger (but under mongrel it wasn't required)

* edit /path/to/redmine/vendor/plugins/redmine_gitosis/lib/gitosis.rb and fix the following

** GITOSIS_URI - this should be the uri for retrieving the gitosis-admin repository

** GITOSIS_BASE_PATH - this should be set to the path where gitosis stores the repositories (used for repository deletes only)

* after install each user should have a link, on the my account page, right next to the change password link

h2. Resources & related discussion

* Ticket on redmine.org: #2525

* Forum thread: http://www.redmine.org/boards/1/topics/9909

h2. License

MIT

h2. Author

Jan Schulz-Hofen, "ROCKET RENTALS GmbH":http://rocket-rentals.de