Building

    In order to ease initial building and for a quick start, we provide an Ubuntu 16 and a Windows based docker containers that have everything needed inside of it to build and statically link Envoy, see ci/README.md.

    In order to build without using the Docker container, follow the instructions at .

    Envoy was initially developed and deployed on Ubuntu 14.04 LTS. It should work on any reasonably recent Linux including Ubuntu 18.04 LTS.

    Building Envoy has the following requirements:

    • GCC 7+ or Clang/LLVM 7+ (for C++14 support). Clang/LLVM 9+ preferred where Clang is used (see below).

    • These Bazel native dependencies.

    Please note that for Clang/LLVM 8 and lower, Envoy may need to be built with as the new tcmalloc code is not guaranteed to compile with lower versions of Clang.

    Envoy now suports Windows as a target platform. The requirements below only apply if you want to build the Windows native executable. If you want to build the Linux version of Envoy on Windows either with WSL or Linux containers please see the Linux requirements above.

    Building Envoy for Windows has the following requirements:

    Please see and building Envoy with Bazel documentation for more information on performing manual builds.

    If you’re interested in modifying Envoy and testing your changes, one approach is to use Docker. This guide will walk through the process of building your own Envoy binary, and putting the binary in an Ubuntu container.