Bananajour - Local git publication and collaboration
Via the best reddit comment ever written:
The logo is the fucking business. The mustache just bring[s] it to a whole other level.
Bananajour is local git repository hosting with a sexy web interface and Bonjour discovery. It's like a bunch of adhoc, local, network-aware githubs!
Unlike Gitjour, the repositories you're serving are not your working git repositories, they're served from
~/.bananajour/repositories. You can push to your bananajour repositories from your working copies just like you do with github.
Follow @bananajour on twitter for all release updates.
Installation and usage
You'll need at least git version 1.6. Run
git --version if you're unsure.
Install it from gemcutter via gems:
gem install bananajour
(you might need to do a
gem sources -a http://gemcutter.org beforehand!)
Start it up:
Go into an existing project and add it to bananajour:
cd ~/code/myproj bananajour add
Publish your codez:
git push banana master
Fire up http://localhost:9331/ to check it out.
If somebody starts sharing a Bananajour repository with the same name on the network it'll automatically show up in the network thanks to the wonder that is Bonjour.
For a list of all the commands:
Optional configuration: you can override the hostname by setting a global git config option like so:
git config --global bananajour.hostname foobar
If you set this setting, then bananajour will assume that you know precisely what you're doing, it will not append .local, it will not check this hostname is valid, or do anything to it. If you set this, then you're on your own.
Make sure you have these ports open on your firewall: 9417 - git - bigbananajour 9418 - git - bananajour 9331 - bananajour 9332 - bigbananajour
To install the dnssd gem on Linux you'll need avahi. For Ubunutu peeps this means:
sudo apt-get install libavahi-compat-libdnssd-dev libavahi-discover
You can debug whether or not Avahi can see Bananajour and git-daemon Bonjour statuses using the command 'avahi-browse'. This command can be found in the package 'avahi-utils'.
The following command will show you all of the Bonjour services running on your local network:
If you kill bananajour with kill -9 it doesn't get a chance to unregister the Bonjour services, and when it is restarted it will die with DNSSD::AlreadyRegisteredError. Although not ideal, you can work around this my restarting avahi-daemon first.
You will also need to uncomment the following line in your /etc/avahi/avahi-daemon.conf.
And then restart the Avahi service:
sudo service avahi-daemon restart
Note: You might have to restart the avahi-daemon sometimes if you are having problems seeing other bananajours.
Using with Ginatra
Rumour has it ginatra can be used to provide richer gitweb-like browsing of your bananajour repositories. Symlink ginatra's
repos directory to
~/.bananajour/repositories to serve up your bananajour repositories.
Official repository and support
The official repo and support issues/tickets live at github.com/toolmantim/bananajour.
Feature and support discussions live at groups.google.com/group/bananajour.
If you want to hack on the sinatra app then do so from a local clone but run your actual bananjour from the gem version. Running the sinatra app directly won't broadcast it onto the network and it'll run on a different port:
ruby sinatra/app.rb -s thin
If you want code reloading use shotgun instead:
shotgun sinatra/app.rb -s thin
If you then want to run your working copy as your public bananajour rebuild and install it as a gem:
sudo rake gem:install
- Carla Hackett (logo)
- Nathan de Vries
- Lachlan Hardy
- Josh Bassett
- Myles Byrne
- Ben Hoskings
- Brett Goulder
- Tony Issakov
- Mark Bennett
- Travis Swicegood
- Nate Haas
- James Sadler
- Jason King
- Michael Pope
All directories and files are MIT Licensed.
Warning to all those who still believe secrecy will save their revenue stream
Bananas were meant to be shared. There are no secret bananas.