installation.md

Installation

There are many different ways to install rq, listed from most preferred to least preferred.

• Generic (Up to date, fast)
• Cargo (Stable releases, slow)
• Manual download (Up to date, fast)
• GitHub releases (Stable releases, fast)
• Arch Linux (Up to date, slow)
• Mac OS X (Out of 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 -sSLf https://sh.dflemstr.io/rq | bash

Cargo

There is a crate available on crates.io, so just run:

cargo install record-query

Manual download

If you don't trust the above script (all it does is to detect your architecture and run curl), you can also manually download rq for your architecture.

• x86_64-unknown-linux-gnu
• x86_64-unknown-linux-musl
• i686-unknown-linux-gnu
• i686-unknown-linux-musl
• x86_64-apple-darwin
• i686-apple-darwin
• arm-unknown-linux-gnueabi
• arm-unknown-linux-musleabi
• arm-unknown-linux-gnueabihf
• arm-unknown-linux-musleabihf
• armv7-unknown-linux-gnueabihf
• armv7-unknown-linux-musleabihf

You need to manually put the downloaded file in e.g. /usr/local/bin and run chmod +x on it.

GitHub releases

There are tagged releases of rq fairly infrequently. You can download pre-built binaries from the GitHub 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