Requirements

Envoy is supported on Debian 8 and above.

Installation

  1. Update apt index.

    $ sudo apt-get update
    
  2. Install packages required for apt to communicate via HTTPS.

    $ sudo apt-get install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg2 \
    software-properties-common
    
  3. Add the Tetrate GPG key.

    $ curl -sL 'https://getenvoy.io/gpg' | sudo apt-key add -
    
  4. Verify the key has the fingerprint 5270 CEAC 57F6 3EBD 9EA9 005D 0253 D0B2 6FF9 74DB.

    $ apt-key fingerprint 6FF974DB
    
    pub   4096R/6FF974DB 2019-03-01
      Key fingerprint = 5270 CEAC 57F6 3EBD 9EA9  005D 0253 D0B2 6FF9 74DB
    uid                  GetEnvoy <getenvoy@tetrate.io>
    sub   4096R/7767A960 2019-03-01
    
  5. Add the stable repository. To add the nightly repository instead, replace the word stable with nightly.

    $ sudo add-apt-repository \
    "deb [arch=amd64] https://dl.bintray.com/tetrate/getenvoy-deb \
    $(lsb_release -cs) \
    stable"
    
  6. Install Envoy binary.

    $ sudo apt-get update && sudo apt-get install -y getenvoy-envoy
    
  7. Verify Envoy is installed.

    $ envoy --version
    

Next steps

Getting Started with Envoy as a Basic Front Proxy

In this tutorial we use Envoy as a basic front proxy to Google and Bing.