Skip to content
Bananajour mirroring for when your bananas go on vacation
Find file
Pull request Compare This branch is even with freshtonic:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
bin
lib
sinatra
.gitignore
Rakefile
Readme.md
TODO
bigbananajour.gemspec
screenshot.png

Readme.md

BigBananajour - Local git mirroring for Bananajour!

Screenshot of local view of Bigbananajour 2.1.3

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 bigbananajour

(you might need to do a gem sources -a http://gemcutter.org beforehand!)

Start it up:

bigbananajour

Fire up http://localhost:9332/ to check it out.

Whenever somebody starts a Bananajour instance on the network, Bigbananajour will slurp up all the published git repos, including all branches. And when some updates a repo, Bigbananajour notices and gets the latest changes. You get backups happening automatically and in one place, plus an alternative place to clone from should the other user switch off their bananajour or go AWOL.

For a list of all the commands:

bigbananajour help

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.

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

Linux support

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:

avahi-browse --all

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.

domain-name=local

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.

Official repository and support

The official repo and support issues/tickets live at github.com/freshtonic/bigbananajour.

Developing

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

Contributors

But the real credit should go to all these awesome people for making Bananajour:

License

All directories and files are MIT Licensed.

Something went wrong with that request. Please try again.