Skip to main content

Gefyra runs all developer machine side components of Gefyra's Kubernetes-based development infrastructure

Project description

Gefyra Logo


Gefyra gives Kubernetes-("cloud-native")-developers a completely new way of writing and testing their applications. Gone are the times of custom Docker-compose setups, Vagrants, custom scripts or other scenarios in order to develop (micro-)services for Kubernetes.

Gefyra Client

The Gefyra client contains a library and a CLI to run Gefyra on a developmer machine. Its main tasks are installation of the Gefyra Operator and the setup of the Docker network and the Cargo sidecar to prepare Gefyra's development infrastructure. For more information please go to:


  • up: setup local development infrastructure
  • run: deploy a new app container into the cluster
  • bridge: intercept the traffic to a container that's running in the cluster and send it to the development container
  • unbridge: remove active traffic intercepts and reset the cluster to its original state
  • down: remove Gefyra's development infrastructure
  • list: list running containers and active bridges
  • check: check local system dependencies
  • version: print the current version and exit

Run new app container in cluster

The Gefyra client can run a new app container in the Kubernetes cluster with gefyra run .... A typical use case is a completely new application that doesn't have any deployed containers in the cluster yet.


  • running local cluster or available remote cluster
  • kubectl connection to development cluster is active
  • a successful gefyra up

Bridge a container

The Gefyra client can bridge (i.e. intercept) a container that is already running in the Kubernetes cluster with gefyra bridge. The container needs to be specified and can be any deployed container of any pod.


  • running local cluster or available remote cluster
  • kubectl connection to development cluster is active
  • successful gefyra up
  • successful gefyra run ...

More Information

Find more information and issues on Github:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gefyra-2.0.1.tar.gz (45.4 kB view hashes)

Uploaded source

Built Distribution

gefyra-2.0.1-py3-none-any.whl (61.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page