Install with Kubernetes YAML

This task walks you through installing Envoy Gateway in your Kubernetes cluster.

The manual installation process does not allow for as much configuration control (e.g. when you are using a custom domain Kubernetes cluster) as the Helm install method, so if you need more control over your Envoy Gateway installation, it is recommended that you use helm.

Before you begin

Envoy Gateway is typically deployed in a Kubernetes cluster. If you don’t have one yet, you can use kind to create a local cluster for testing purposes.

Install with YAML

1. In your terminal, run the following command:

   kubectl apply --server-side -f https://github.com/envoyproxy/gateway/releases/download/v1.8.0/install.yaml
   

2. Next Steps

   Envoy Gateway should now be successfully installed and running, but in order to experience more abilities of Envoy Gateway, you can refer to Tasks.

Upgrading from the previous version

Some manual migration steps are required to upgrade Envoy Gateway.

1. Update Gateway-API and Envoy Gateway CRDs:

helm template eg-crds oci://docker.io/envoyproxy/gateway-crds-helm \
  --version v1.8.0 \
  --set crds.gatewayAPI.enabled=true \
  --set crds.envoyGateway.enabled=true \
  | kubectl apply --force-conflicts --server-side -f -

2. Install Envoy Gateway v1.8.0:

helm upgrade eg oci://docker.io/envoyproxy/gateway-helm --version v1.8.0 -n envoy-gateway-system

Open Ports

These are the ports used by Envoy Gateway and the managed Envoy Proxy.

Envoy Gateway

EnvoyProxy