Get started
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 kubectl
and helm
installed. For full installation instructions, see Install kgateway.
Install kgateway
-
Use a Kubernetes cluster. For quick testing, you can use Kind.
kind create cluster
-
Deploy the Kubernetes Gateway API CRDs.
kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.2.1/standard-install.yaml
-
Install kgateway by using Helm.
helm install --create-namespace --namespace kgateway-system --version v2.0.0-main kgateway oci://ghcr.io/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.
Next steps
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 abasic 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