# Installation
There are many different ways to install `rq`, listed from most preferred
to least preferred.
TODO: this section will soon be updated!
* [Generic](#generic) (Up to date, fast)
* [Cargo](#cargo) (Stable releases, slow)
* [GitHub releases](#github-releases) (Stable releases, fast)
* [Arch Linux](#arch-linux) (Up to date, slow)
* [Mac OS X](#mac-os-x) (Out of date, slow)
* [Nix](#nix) (Up to date, slow)
## Generic
There is a generic best-effort installer available via the dreaded
`curl | bash` method. This is the preferred method, because you don't
need to compile `rq` from scratch, and you always get the latest
version.
curl -LSfs https://japaric.github.io/trust/install.sh | sh -s -- --git dflemstr/rq
## Cargo
There is a crate available on [crates.io](https://crates.io/), so just run:
cargo install record-query
## GitHub releases
There are tagged releases of `rq` fairly infrequently. You can
download pre-built binaries from the
[GitHub releases](https://github.com/dflemstr/rq/releases) page. Note
that these might be very out of date compared to `master`.
## Arch Linux
There is a package available for AUR, so it can be installed with for
example `pacaur`:
pacaur -S record-query-git
This takes a while to install because `rq` will be built from source.
## Mac OS X
There is a Homebrew tap available. Add it like this:
brew tap dflemstr/tools
This will let you install the latest version of `rq` (recommended):
brew install --HEAD rq
Note that the compilation might take some time, use `-v` for details.
If you for some reason want the last tagged release of `rq` (might be
severely out of date):
brew install rq
## Nix
`rq` is available in nixpkgs. You can install it via `nix-env`:
nix-env -i rq
Or add to packages list if you use [Home Manager](https://github.com/rycee/home-manager):
home.packages = [ pkgs.rq ]