Installing from sourceΒΆ

Here's how to install GRR for development (from github HEAD):

First, install the prerequisites:

  • Ubuntu:
sudo apt install -y fakeroot debhelper libffi-dev libssl-dev python-dev \
  python-pip wget openjdk-8-jdk zip git devscripts dh-systemd dh-virtualenv \
  libc6-i386 lib32z1 asciidoc
  • Centos:
sudo yum install -y epel-release python-devel wget which java-1.8.0-openjdk \
  libffi-devel openssl-devel zip git gcc gcc-c++ redhat-rpm-config rpm-build \

sudo yum install -y python-pip

Next, upgrade pip and install virtualenv:

sudo pip install --upgrade pip virtualenv

Next, download the github repo and cd into its directory:

git clone

cd grr

If protoc is already installed, make sure it is present in the PATH, or set the environment variable PROTOC to the full path of the protoc binary.

If protoc is not installed, download it with:

travis/ linux

Finally, create a virtualenv at $HOME/INSTALL and install GRR in the virtualenv:

virtualenv $HOME/INSTALL


You should now be able to run GRR commands from inside the virtualenv, e.g:

source $HOME/INSTALL/bin/activate

grr_config_updater initialize # Initialize GRR's configuration