# Gefyra Documentation

> Gefyra - Kubernetes Development Environment

## Documentation Sets

- [Gefyra Documentation](https://gefyra.dev//llms-full.txt): Gefyra - Kubernetes Development Environment

## LandingEn

- [Hello from Gefyra | Blazingly-fast rocket, rock-solid, local application development arrow_right with Kubernetes.](https://gefyra.dev/raw/en.md): Gefyra enables blazingly-fast, reliable local application development with Kubernetes. Streamline your workflow, boost productivity, and build with confidence using Gefyra’s powerful development tools.

## DocsEn

- [Introduction](https://gefyra.dev/raw/en/quick-start/introduction.md)
- [Installation](https://gefyra.dev/raw/en/quick-start/installation.md): Gefyra is tested under Windows, MacOS and Linux. The command line tool can be installed with a binary executable. Please find your preferred operating system below.
- [Getting Started](https://gefyra.dev/raw/en/quick-start/getting-started.md): This guide describes the usage of Gefyra for the local development of a Kubernetes application running in Minikube.
- [Docker Desktop Extension](https://gefyra.dev/raw/en/quick-start/docker-desktop-extension.md): Gefyra's Docker Desktop Extension allows you to run containers on your local machine and connect them to Kubernetes-based resources. It is a great way to test a new service in the cluster or write code that depends on Kubernetes resources.
- [Command line tool (CLI)](https://gefyra.dev/raw/en/quick-start/cli.md): Gefyra's CLI allows you to run containers on your local machine and connect them to Kubernetes-based resources.
- [Getting Started With Local Kubernetes Cluster](https://gefyra.dev/raw/en/local-environments/getting-started.md): This chapter contains guides on how to get started with Gefyra and different local Kubernetes solutions. These guides are for a single user on a local machine.
- [Getting started with Gefyra and Colima Kubernetes](https://gefyra.dev/raw/en/local-environments/colima.md): This guide will show you how to use Gefyra for the local development of a Kubernetes application running in Colima Kubernetes.
- [Getting started with Gefyra and Docker Desktop Kubernetes on MacOS](https://gefyra.dev/raw/en/local-environments/docker-desktop-osx.md): This example is really similar to the k3d getting started guide. However, Docker Desktop's Kubernetes comes with some specialities which must be taken care of to make this guide work.
- [Getting started with Gefyra and k3d](https://gefyra.dev/raw/en/local-environments/k3d.md): This guide will show you how to use Gefyra for the local development of a Kubernetes application running in k3d.
- [Getting started with Gefyra and kind](https://gefyra.dev/raw/en/local-environments/kind.md): This guide will show you how to use Gefyra for the local development of a Kubernetes application running in kind.
- [Getting started with Gefyra and Minikube](https://gefyra.dev/raw/en/local-environments/minikube.md)
- [Setting up a Shared Kubernetes Cluster](https://gefyra.dev/raw/en/shared-environments/getting-started.md): This chapter contains guides on how to set up shared remote Kubernetes for Gefyra. These guides are usually for multiple client use cases.
- [Gefyra (Remote) Cluster Installation](https://gefyra.dev/raw/en/shared-environments/installation.md): Installing Gefyra to a remote cluster is usually slightly different to a local setup. This is because the networking aspect differs considerably between a local cluster, that might be created with overlay networks and port-forwarding, and remote clusters with cloud-specific routing components. Starting with Gefyra 2, you get good control of the cluster-side components.
- [Working With Gefyra Clients](https://gefyra.dev/raw/en/shared-environments/clients.md): Gefyra introduces the concept of Gefyra Clients. These are objects to manage and distribute access to the cluster.
- [Connecting to Gefyra](https://gefyra.dev/raw/en/shared-environments/connecting.md): Connecting to a Gefyra-enabled Kubernetes cluster is the process of any Gefyra client to establish a networking connection based on Wireguard VPN to a cluster. It is a multistep process that involves the dynamic creation of connection credentials and IP-range negotiation between cluster and client. The network connection is persistent for the session, rock-solid and blazingly fast.
- [Setting up Shared Kubernetes Clusters](https://gefyra.dev/raw/en/remote-k8s/getting-started.md): This chapter contains guides on how to set up shared remote Kubernetes for Gefyra. These guides are for multiple clients use cases.
- [Getting started with Gefyra and the Google Cloud Platform](https://gefyra.dev/raw/en/remote-k8s/gcp.md): This guide will show you how to use Gefyra for the remote development of a Kubernetes Application running in the Google Kubernetes Engine (GKE).
- [Getting started with Gefyra and Elastic Kubernetes Service (EKS)](https://gefyra.dev/raw/en/remote-k8s/eks.md): This guide will show you how to use Gefyra for the remote development of a Kubernetes application running on Elastic Kubernetes Service (EKS).
- [Getting started with Gefyra and SysEleven MetaKube](https://gefyra.dev/raw/en/remote-k8s/sys11.md): This guide will show you how to use Gefyra for the remote development of a Kubernetes application running on MetaKube.
- [Use Cases and Demos](https://gefyra.dev/raw/en/usecases-and-demos/getting-started.md): This chapter contains example use cases and demos. Feel free to adapt these architectures to your applications.
- [Developing Go Applications with Gefyra](https://gefyra.dev/raw/en/usecases-and-demos/golang.md): This example demonstrates how to run a local Golang container with hot code reloading as part of your Kubernetes namespace.
- [Create a Backend Application with a Sidecar and OAuth2 Authentication](https://gefyra.dev/raw/en/usecases-and-demos/oauth2-demo.md): This example demonstrates how to develop a Kubernetes sidecar pattern for an OAuth2 (OpenID Connect) authorized backend service using Gefyra.
- [Developing a backend application with Django on the Google Kubernetes Engine (GKE)](https://gefyra.dev/raw/en/usecases-and-demos/remote-gke.md): This guide will show you how to use Gefyra for the local development of a Kubernetes Application running in GKE. Gefyra is able to spin up a local container which behaves like it was part of the cluster already. This way you can run services inside the cluster without abstaining from features like hot code reload. Sounds good? Lets go!
- [Making any container part of your Kubernetes namespace](https://gefyra.dev/raw/en/usecases-and-demos/ubuntu-in-namespace.md): This example demonstrates how to run a local Ubuntu container instance as part of your Kubernetes namespace.
- [How does it work?](https://gefyra.dev/raw/en/technical-details/architecture.md): In order to write software for and with Kubernetes, obviously a Kubernetes cluster is required. There are already a number of Kubernetes distributions available to run everything locally. A cloud-based Kubernetes cluster can be connected as well in order to spare the development computer from blasting off. A working KUBECONFIG connection is required with appropriate permissions which should always be the case for local clusters. Gefyra installs the required cluster-side components by itself once a development setup is about to be established.
- [What is Gefyra?](https://gefyra.dev/raw/en/technical-details/what-is-gefyra.md): Gefyra is a toolkit written in Python to organize a local development infrastructure in order to produce software for and with Kubernetes while having fun. It is installed on any development computer and starts its work when it is asked. Gefyra runs as a user-space application and controls the local Docker host and Kubernetes via Kubernetes Python Client.
- [Run vs. Bridge Operation](https://gefyra.dev/raw/en/information/run-vs-bridge.md): Gefyra support two modes of operation: run and bridge. Let's dive into the differences.
- [What changed between Gefyra v1 and Gefyra v2?](https://gefyra.dev/raw/en/information/v1-vs-v2.md): Operator - Gefyra's operator was completely refactored. It now acts as a state machine and shows much more stable and consistent
behaviour. It manages 2 custom resources - GefyraClients and GefyraBridges.
- [Media](https://gefyra.dev/raw/en/information/media.md): Videos, podcasts and other media about Gefyra.
- [About Gefyra](https://gefyra.dev/raw/en/information/about.md): Gefyra is based on well-crafted open-source software. Special credits go to the teams of linxuserver.io be sure to check out their awesome work. Gefyra was heavily inspired by the free part of Telepresence 2.