Installation
+
+ This chapter explains how to install Hydra on your own build farm server.
+
+
Prerequisites
To install and use Hydra you need to have installed the following dependencies:
+
- Nix
- PostgreSQL
+ Nix
+ either PostgreSQL or SQLite
+ many Perl packages, notably Catalyst,
+ EmailSender, and NixPerl (see the Hydra
+ expression in Nixpkgs for the complete
+ list).
- At the moment, Hydra runs only on 32 bit and 64 bit Linux (i686-linux and x86_64_linux).
+
+ At the moment, Hydra runs only on GNU/Linux
+ (i686-linux and
+ x86_64_linux).
+
+
+ For small projects, Hydra can be run on any reasonably
+ modern machine. For individual projects you can even run
+ Hydra on a laptop. However, the charm of a buildfarm server
+ is usually that it operates without disturbing the
+ developer's working environment and can serve releases over
+ the internet. In conjunction you should typically have your
+ source code administered in a version management system,
+ such as subversion. Therefore, you will probably want to
+ install a server that is connected to the internet. To scale
+ up to large and/or many projects, you will need at least a
+ considerable amount of diskspace to store builds. Since
+ Hydra can schedule multiple simultaneous build jobs, it can
+ be useful to have a multi-core machine, and/or attach
+ multiple build machines in a network to the central Hydra
+ server.
+
+
+
+ Of course we think it is a good idea to use the NixOS GNU/Linux
+ distribution for your buildfarm server. But this is not a
+ requirement. The Nix software deployment system can be
+ installed on any GNU/Linux distribution in parallel to the
+ regular package management system. Thus, you can use Hydra
+ on a Debian, Fedora, SuSE, or Ubuntu system.
+
+
+ Getting Nix
+
+
+ If your server runs NixOS you are all set to continue with
+ installation of Hydra. Otherwise you first need to install
+ Nix. The latest stable version can be found one the Nix web
+ site, along with a manual, which includes installation
+ instructions.
+
+
+
Installation
+
+
+ Hydra can be installed using Nixpkgs:
+
+
+ nix-env -Ai hydra -f /path/to/nixpkgs
+
+ This makes the tools available in your Nix user environment,
+ $HOME/.nix-profile by default.
+
+
- Hydra can be installed by visiting the URL,
-
-http://hydra.nixos.org/view/hydra/unstable
- and use the one-click install available at one of the build pages. You could also
+ Alternatively, the latest development snapshot can be
+ installed by visiting the URL
+ http://hydra.nixos.org/view/hydra/unstable
+ and use the one-click install available at one of the build pages. You can also
install Hydra through the channel by performing the following commands:
nix-channel --add http://hydra.nixos.org/jobset/hydra/trunk/channel/latest
nix-channel --update
nix-env -i hydra
-
+
+
+ Command completion should reveal a number of command-line tools from Hydra:
+
+
+hydra_build.pl hydra_eval_jobs hydra_server.pl
+hydra_control.sh hydra_evaluator.pl hydra_update_gc_roots.pl
+hydra_create.pl hydra_queue_runner.pl
+