Skip to main content
Version: 1.x

Getting started with Gefyra and kind

This guide will show you how to use Gefyra for the local development of a Kubernetes application running in kind.


  1. Follow the installation for your preferred platform.

  2. Create a local Kubernetes cluster with kind like this: Create a file kind-config.yaml:

kind: Cluster
- role: control-plane
- containerPort: 31820
hostPort: 31820
protocol: udp


kind create cluster --config kind-config.yaml

Running Gefyra

  1. Set up Gefyra with
gefyra up
  1. Run a local Docker image with Gefyra in order to make it part of the cluster.

    1. Build your Docker image with a local tag, for example from the testing directory: cd testing/images/ && docker build -f Dockerfile.local . -t pyserver
    2. Execute Gefyra's run command:
      gefyra run -i pyserver -N mypyserver -n default
    3. exec into the running container and look around. You will find the container to run within your Kubernetes cluster.
      docker exec -it mypyserver bash
      wget -O- hello-nginx
      will print out the website of the cluster service hello-nginx from within the cluster.
  2. Create a bridge in order to intercept the traffic to the cluster application with the one running locally:

gefyra bridge -N mypyserver -n default --port 8000:80 --target deploy/hello-nginxdemo/hello-nginx

Check out the locally running server comes up under:

  1. List all running bridges:
gefyra list --bridges
  1. Unbridge the local container and reset the cluster to its original state:
gefyra unbridge -N mypybridge

Check out the initial response from:

Cleaning up

  1. Remove Gefyra's components from the cluster with
gefyra down
  1. Remove the locally running Kubernetes cluster with kind delete cluster

Provide us with your feedback

Did everything work as expected? How was the experience of using Gefyra? We'd appreciate if you could take 2 minutes of your time to fill out our feedback form.