====== The Brightbox Ubuntu Apt Repository ======
Brightbox maintain packages for Ubuntu Hardy and Dapper to make life easier for Rails users.  These are obtainable from the Brightbox APT repository.

Brightboxes are already set up to use the APT repository by default, but they're publicly available for anyone running Ubuntu to use.

For Dapper, we provide a few backported packages, such as Apache, NGINX and git.

For Hardy, we provide extras such as Passenger/mod_rails and Sphinx. [[docs:brightboxaptrepository:packages|More details of the packages available are here]].

===== Using the stable repository =====

If you're not on a Brightbox, this is how to use the repository.  Import our apt repository key:

<code bash>
wget http://apt.brightbox.net/release.asc -O - | sudo apt-key add -
</code>

Then download the appropriate sources file:

=== Hardy ===

<code bash>
sudo wget -c http://apt.brightbox.net/sources/hardy/brightbox.list -P /etc/apt/sources.list.d/
</code>

=== Dapper ===

<code bash>
sudo wget -c http://apt.brightbox.net/sources/dapper/brightbox.list -P /etc/apt/sources.list.d/
</code>


Then install packages:

<code bash>
sudo apt-get update
sudo apt-get install sphinx-search
</code>


===== The Testing Repository =====

The testing repository is where we put newer packages for people to test, unsurprisingly.

You shouldn't leave this repository in your sources list and do blind upgrades as new packages might appear here that break things.  (In particular, new Ruby packages might break any gems you have with native extensions).

For Hardy, we're currently testing Phusion Passenger and NGINX packages.

For Dapper, we have backported [[docs:ruby:1.8.6|Ruby 1.8.6 p111]] packages, [[docs:imagemagick:6.3|ImageMagick 6.3]] packages, newer NGINX packages, newer GIT packages and a few others.

==== Using the testing repository ====

Add our repository key as per the stable repository.  Then download the appropriate testing repository sources file.

=== Hardy ===

<code bash>
sudo wget -c http://apt.brightbox.net/sources/hardy/brightbox-testing.list -P /etc/apt/sources.list.d/
</code>

=== Dapper ===

<code bash>
sudo wget -c http://apt.brightbox.net/sources/dapper/brightbox-testing.list -P /etc/apt/sources.list.d/
</code>