System Setup

Supported Platforms

• Ubuntu 18.04 (LTS)
• macOS 10.13+

If you are not running one of the above supported platforms, the recommended (and supported) setup is to use (the supplied) Docker container image. See Docker.

Toolchain

• C++17-enabled compiler (GCC 7.0+ or Apple Clang 9.1+)
• CMake 3.2+
• LLVM 6.0+

Ubuntu Setup

1. Install git:

   sudo apt install git

2. Clone the Terrier repository:

   git clone --recursive https://github.com/cmu-db/terrier.git

3. Install the package dependencies:

   cd terrier/script/installation
   sudo bash packages.sh

4. Proceed to Building Terrier.

macOS Setup

1. Command Line Tools: Download Command Line Tools for your system from Apple (login required). The latest confirmed working version is Command Line Tools for Xcode 9.4.

2. Clone the Terrier repository:

   git clone --recursive https://github.com/cmu-db/terrier.git

3. Install the package dependencies:

   cd terrier/script/installation
   bash packages.sh

   If you encounter permissions issues, run brew doctor and follow the instructions:

4. Proceed to Building Terrier.