Get started with kgateway

Get started with kgateway, a cloud-native Layer 7 proxy that is based on the Envoy and Kubernetes Gateway API projects.

Before you begin

These quick start steps assume that you have a Kubernetes cluster, kubectl, and helm already set up. For quick testing, you can use Kind.

kind create cluster

The following steps get you started with a basic installation. For instructions, see the installation guide.

Deploy the Kubernetes Gateway API CRDs.

kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.2.1/standard-install.yaml

Deploy the kgateway CRDs by using Helm. The following command uses the latest stable release, v2.0.3. For active development, update the version to v2.1.0-main.
```
helm upgrade -i --create-namespace --namespace kgateway-system --version v2.0.3 kgateway-crds oci://cr.kgateway.dev/kgateway-dev/charts/kgateway-crds
```
Install kgateway by using Helm. The following command uses the latest stable release, v2.0.3. For active development, update the version to v2.1.0-main.
```
helm upgrade -i --namespace kgateway-system --version v2.0.3 kgateway oci://cr.kgateway.dev/kgateway-dev/charts/kgateway
```

Make sure that kgateway is running.

kubectl get pods -n kgateway-system

Example output:

NAME                        READY   STATUS    RESTARTS   AGE
kgateway-5495d98459-46dpk   1/1     Running   0          19s

Good job! You now have the kgateway control plane running in your cluster.

Ready to try out more features? Check out the following guides:

Install a sample app such as httpbin. This guide includes setting up an API gateway, configuring a basic HTTP listener on the API gateway, and routing traffic to httpbin by using an HTTPRoute resource.
Set up an API gateway with a listener so that you can start routing traffic to your apps.

No longer need kgateway? Uninstall with the following command:

helm uninstall kgateway -n kgateway-system