Page tree
Skip to end of metadata
Go to start of metadata

This page describes how to build Impala from source and how to configure and run Impala in a single node development environment. 

Prerequisites and Requirements

Hardware Requirements

  • CPU must support at least SSSE3
  • Minimum Memory: 8GB

Supported Operating Systems


  • Ubuntu 14.04, 16.04


Not supported


Not supported

Installing and Configuring Impala

  1. Install prerequisites

    (warning) Instead awleblang/impala-setup, as of Dec 2017, we recommend to setup your Ubuntu 16.04 or Ubuntu 14.04 machine.

    Older instructions:
    git clone

    cd impala-setup
    chmod +x
    sudo ./


    If you are running on a platform that is not supported by the above script, you will have to install prerequisites and set up your machine manually. Impala Build Prerequisites has some information that can guide you.

  2. Clone the Impala git repo and change to the new Impala directory.

  3. Set the following environment variables in your `.bashrc` or elsewhere:

  4. Build Impala.

    You may hit an error here in if you are building Impala on an operating system for which prebuilt toolchain binaries are not available. In that case you will need to build native-toolchain from scratch then retry this step.

    Want faster builds?

    Doing a full build of Impala can take quite a while! While you wait, check out Tips for Faster Impala Builds.

  5. Start supporting services.

  6. Start the Impala cluster.

  7. Check that everything works correctly.

  8. Have fun...
  9. Recompile and restart the Impala cluster for your changes to take effect.



  • No labels


  1. In my opinion this page is made obsolete by bin/ Any objection to deleting it?

    1. I think this is still somewhat useful in that it provides some additional explanation of what the build does and workflow after the first full build (it's not great for that, but better than nothing). I'd probably prefer to leave it until we can strip away the unnecessary stuff and make it better focused on steps after bootstrapping.