[{"data":1,"prerenderedAt":360},["ShallowReactive",2],{"navigation_docs_en":3,"-en-architecture-components":225,"-en-architecture-components-surround":355},[4,25,41,66,85,140,167,181,195],{"title":5,"path":6,"stem":7,"children":8,"icon":10},"Quickstart","\u002Fen\u002Fquickstart","en\u002F1.quickstart\u002F1.index",[9,11,16,20],{"title":5,"path":6,"stem":7,"icon":10},"i-lucide-rocket",{"title":12,"path":13,"stem":14,"icon":15},"Installation","\u002Fen\u002Fquickstart\u002Finstallation","en\u002F1.quickstart\u002F2.installation","i-lucide-download",{"title":17,"path":18,"stem":19,"icon":10},"First Bridge","\u002Fen\u002Fquickstart\u002Ffirst-bridge","en\u002F1.quickstart\u002F3.first-bridge",{"title":21,"path":22,"stem":23,"icon":24},"Docker Desktop Extension","\u002Fen\u002Fquickstart\u002Fdocker-desktop-extension","en\u002F1.quickstart\u002F4.docker-desktop-extension","i-simple-icons-docker",{"title":26,"path":27,"stem":28,"children":29,"page":40},"Ai Agents","\u002Fen\u002Fai-agents","en\u002F2.ai-agents",[30,35],{"title":31,"path":32,"stem":33,"icon":34},"Cluster Ground Truth","\u002Fen\u002Fai-agents\u002Fcluster-ground-truth","en\u002F2.ai-agents\u002F1.cluster-ground-truth","i-lucide-bot",{"title":36,"path":37,"stem":38,"icon":39},"Agent Workflows","\u002Fen\u002Fai-agents\u002Fagent-workflows","en\u002F2.ai-agents\u002F2.agent-workflows","i-lucide-workflow",false,{"title":42,"path":43,"stem":44,"children":45,"page":40},"Developer Workflows","\u002Fen\u002Fdeveloper-workflows","en\u002F3.developer-workflows",[46,51,56,61],{"title":47,"path":48,"stem":49,"icon":50},"Hot Reloading","\u002Fen\u002Fdeveloper-workflows\u002Fhot-reloading","en\u002F3.developer-workflows\u002F1.hot-reloading","i-lucide-zap",{"title":52,"path":53,"stem":54,"icon":55},"IDE Debugging","\u002Fen\u002Fdeveloper-workflows\u002Fide-debugging","en\u002F3.developer-workflows\u002F2.ide-debugging","i-lucide-bug",{"title":57,"path":58,"stem":59,"icon":60},"Run vs. Bridge","\u002Fen\u002Fdeveloper-workflows\u002Fbridge-vs-run","en\u002F3.developer-workflows\u002F3.bridge-vs-run","i-lucide-git-compare-arrows",{"title":62,"path":63,"stem":64,"icon":65},"Database and DNS","\u002Fen\u002Fdeveloper-workflows\u002Fdatabase-and-dns","en\u002F3.developer-workflows\u002F4.database-and-dns","i-lucide-database",{"title":67,"path":68,"stem":69,"children":70,"page":40},"Team And Enterprise","\u002Fen\u002Fteam-and-enterprise","en\u002F4.team-and-enterprise",[71,75,80],{"title":72,"path":73,"stem":74,"icon":10},"Getting Started","\u002Fen\u002Fteam-and-enterprise\u002Fshared-staging-clusters","en\u002F4.team-and-enterprise\u002F1.shared-staging-clusters",{"title":76,"path":77,"stem":78,"icon":79},"Managing Gefyra Clients","\u002Fen\u002Fteam-and-enterprise\u002Frbac-and-security","en\u002F4.team-and-enterprise\u002F2.rbac-and-security","i-lucide-computer",{"title":81,"path":82,"stem":83,"icon":84},"CI Cost Reduction","\u002Fen\u002Fteam-and-enterprise\u002Fci-cost-reduction","en\u002F4.team-and-enterprise\u002F3.ci-cost-reduction","i-lucide-trending-down",{"title":86,"path":87,"stem":88,"children":89,"page":40},"Cluster Guides","\u002Fen\u002Fcluster-guides","en\u002F5.cluster-guides",[90,116,121],{"title":91,"path":92,"stem":93,"children":94,"page":40},"Local Clusters","\u002Fen\u002Fcluster-guides\u002Flocal-clusters","en\u002F5.cluster-guides\u002F1.local-clusters",[95,100,104,108,112],{"title":96,"path":97,"stem":98,"icon":99},"Colima Kubernetes","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fcolima","en\u002F5.cluster-guides\u002F1.local-clusters\u002F1.colima","i-simple-icons-kubernetes",{"title":101,"path":102,"stem":103,"icon":24},"Docker Desktop Kubernetes (OSX)","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fdocker-desktop","en\u002F5.cluster-guides\u002F1.local-clusters\u002F2.docker-desktop",{"title":105,"path":106,"stem":107},"k3d","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fk3d","en\u002F5.cluster-guides\u002F1.local-clusters\u002F3.k3d",{"title":109,"path":110,"stem":111},"kind","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fkind","en\u002F5.cluster-guides\u002F1.local-clusters\u002F4.kind",{"title":113,"path":114,"stem":115,"icon":99},"minikube","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fminikube","en\u002F5.cluster-guides\u002F1.local-clusters\u002F5.minikube",{"title":117,"path":118,"stem":119,"icon":120},"Overview","\u002Fen\u002Fcluster-guides\u002Foverview","en\u002F5.cluster-guides\u002F1.overview","i-lucide-network",{"title":122,"path":123,"stem":124,"children":125,"page":40},"Remote Clouds","\u002Fen\u002Fcluster-guides\u002Fremote-clouds","en\u002F5.cluster-guides\u002F2.remote-clouds",[126,131,136],{"title":127,"path":128,"stem":129,"icon":130},"Google Cloud Platform (GCP)","\u002Fen\u002Fcluster-guides\u002Fremote-clouds\u002Fgke","en\u002F5.cluster-guides\u002F2.remote-clouds\u002F1.gke","i-material-icon-theme:gcp",{"title":132,"path":133,"stem":134,"icon":135},"Elastic Kubernetes Service (EKS)","\u002Fen\u002Fcluster-guides\u002Fremote-clouds\u002Feks","en\u002F5.cluster-guides\u002F2.remote-clouds\u002F2.eks","i-simple-icons-amazoneks",{"title":137,"path":138,"stem":139,"icon":99},"SysEleven MetaKube","\u002Fen\u002Fcluster-guides\u002Fremote-clouds\u002Fsyseleven","en\u002F5.cluster-guides\u002F2.remote-clouds\u002F3.syseleven",{"title":141,"path":142,"stem":143,"children":144,"page":40},"Use Cases and Demos","\u002Fen\u002Fusecases-and-demos","en\u002F5.usecases-and-demos",[145,148,153,158,162],{"title":72,"path":146,"stem":147,"icon":10},"\u002Fen\u002Fusecases-and-demos\u002Fgetting-started","en\u002F5.usecases-and-demos\u002F1.getting-started",{"title":149,"path":150,"stem":151,"icon":152},"Developing Go Applications with Gefyra","\u002Fen\u002Fusecases-and-demos\u002Fgolang","en\u002F5.usecases-and-demos\u002F2.golang","i-simple-icons-go",{"title":154,"path":155,"stem":156,"icon":157},"OAuth2 Demo with a Sidecar","\u002Fen\u002Fusecases-and-demos\u002Foauth2-demo","en\u002F5.usecases-and-demos\u002F3.oauth2-demo","i-devicon-plain:oauth",{"title":159,"path":160,"stem":161,"icon":130},"Remote Development on Google Kubernetes Engine","\u002Fen\u002Fusecases-and-demos\u002Fremote-gke","en\u002F5.usecases-and-demos\u002F4.remote-gke",{"title":163,"path":164,"stem":165,"icon":166},"Run an Ubuntu Container instance","\u002Fen\u002Fusecases-and-demos\u002Fubuntu-in-namespace","en\u002F5.usecases-and-demos\u002F5.ubuntu-in-namespace","i-simple-icons-ubuntu",{"title":168,"path":169,"stem":170,"children":171,"page":40},"Architecture","\u002Fen\u002Farchitecture","en\u002F6.architecture",[172,176],{"title":168,"path":173,"stem":174,"icon":175},"\u002Fen\u002Farchitecture\u002Fhow-gefyra-works","en\u002F6.architecture\u002F1.how-gefyra-works","i-lucide-square-chevron-right",{"title":177,"path":178,"stem":179,"icon":180},"Gefyra Components","\u002Fen\u002Farchitecture\u002Fcomponents","en\u002F6.architecture\u002F2.components","i-lucide-circle-question-mark",{"title":182,"path":183,"stem":184,"children":185,"page":40},"Comparisons","\u002Fen\u002Fcomparisons","en\u002F7.comparisons",[186,191],{"title":187,"path":188,"stem":189,"icon":190},"Gefyra vs. Telepresence","\u002Fen\u002Fcomparisons\u002Fgefyra-vs-telepresence","en\u002F7.comparisons\u002F1.gefyra-vs-telepresence","i-lucide-git-compare",{"title":192,"path":193,"stem":194,"icon":190},"Gefyra vs. mirrord","\u002Fen\u002Fcomparisons\u002Fgefyra-vs-mirrord","en\u002F7.comparisons\u002F2.gefyra-vs-mirrord",{"title":196,"path":197,"stem":198,"children":199,"page":40},"Reference","\u002Fen\u002Freference","en\u002F8.reference",[200,205,210,215,220],{"title":201,"path":202,"stem":203,"icon":204},"CLI","\u002Fen\u002Freference\u002Fcli","en\u002F8.reference\u002F1.cli","i-lucide-square-terminal",{"title":206,"path":207,"stem":208,"icon":209},"CRD Reference","\u002Fen\u002Freference\u002Fcrd-reference","en\u002F8.reference\u002F2.crd-reference","i-lucide-file-code",{"title":211,"path":212,"stem":213,"icon":214},"What changed in Gefyra 2?","\u002Fen\u002Freference\u002Fv1-vs-v2","en\u002F8.reference\u002F3.v1-vs-v2","i-lucide-history",{"title":216,"path":217,"stem":218,"icon":219},"Media","\u002Fen\u002Freference\u002Fmedia","en\u002F8.reference\u002F4.media","i-lucide-play",{"title":221,"path":222,"stem":223,"icon":224},"About","\u002Fen\u002Freference\u002Fabout","en\u002F8.reference\u002F5.about","i-lucide-info",{"id":226,"title":177,"body":227,"description":348,"extension":349,"links":350,"meta":351,"navigation":352,"path":178,"seo":353,"stem":179,"__hash__":354},"docs_en\u002Fen\u002F6.architecture\u002F2.components.md",{"type":228,"value":229,"toc":341},"minimark",[230,240,248,251,276,279,282,287,290,294,334,338],[231,232,233],"p",{},[234,235],"img",{"alt":236,"className":237,"src":239},"Gefyra controls docker and kubeapi",[238],"mx-auto","\u002Fimg\u002Fgefyra-intro.png",[231,241,242,243,247],{},"(",[244,245,246],"em",{},"Kubectl"," is not really required but kinda makes sense to be in this picture)",[231,249,250],{},"In order for this to work, a few requirements have to be satisfied:",[252,253,254,267,270,273],"ul",{},[255,256,257,258,266],"li",{},"a Docker host must be available for the user on the development machine (it is convenient if ",[259,260,265],"a",{"href":261,"rel":262,"target":264},"https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Finstall\u002Flinux-postinstall\u002F#manage-docker-as-a-non-root-user",[263],"nofollow","_blank","docker can be run without sudo-privileges",")",[255,268,269],{},"Overlay networking must be supported by the Docker host",[255,271,272],{},"there are a few container capabilities required on both sides, within the Kubernetes cluster and on the local computer",[255,274,275],{},"a node port must be opened on the development cluster for the duration of the development work",[231,277,278],{},"Gefyra makes sure your development container runs as part of the cluster while you still have full access to it. In addition,\nGefyra is able to intercept the target application running within the cluster, i.e. a container in a Pod, and tunnels all traffic hitting said container to the one running\nlocally.",[231,280,281],{},"Now, developers can add new code or fix bugs and run it right away in the Kubernetes cluster, or simply introspect the traffic.\nGefyra provides the entire infrastructure to do so and provides a high level of developer convenience.",[283,284,286],"h2",{"id":285},"did-i-hear-developer-convenience","Did I hear developer convenience?",[231,288,289],{},"The idea is to relieve developers from the hassle to go back and forth to the integration system with containers. Instead, take\nthe integration system closer to the developer and make the development cycles as short as possible. No more waiting for the CI to complete\njust to see the service failing on the first request. Cloud-native (or Kubernetes-native) technologies have completely changed the\ndeveloper experience: infrastructure is increasingly becoming part of developer's business with all the barriers and obstacles, but also chances\nto turn the software for the better.\nGefyra is here to provide a development workflow with the highest convenience possible. It brings low setup times, rapid development,\nhigh release cadence and super-satisfied managers.",[283,291,293],{"id":292},"gotchas-current-limitations","Gotchas & Current Limitations",[252,295,296,309,320,331],{},[255,297,298,299,303,304,308],{},"Gefyra's VPN needs a reachable ",[300,301,302],"code",{},"NodePort",". In most non-local Kubernetes scenarios this requires to set a firewall rule\nin order to ",[305,306,307],"strong",{},"allow port 31820 for UDP traffic",". It's simple for most Cloud-providers (\"Hyperscaler\") and\ndoable for custom installations, too.",[255,310,311,312,315,316,319],{},"Kubernetes-probes can be faked by Gefyra's Pod component (\"Carrier\") in order to keep Kubernetes from removing ",[244,313,314],{},"bridged"," Pods.\nHowever, this is currently only supported for ",[300,317,318],{},"httpGet"," probes. Otherwise, you need to turn off probes during development.",[255,321,322,323,326,327,330],{},"You will experience issues if you want to ",[244,324,325],{},"bridge"," containers in Pods which specify a specific ",[300,328,329],{},"command"," (other than common shells).",[255,332,333],{},"This project is in a quite early stage. I assume there are still a few bugs around.",[283,335,337],{"id":336},"why-gefyra","Why \"Gefyra\"?",[231,339,340],{},"\"Gefyra\" is the Greek word for \"Bridge\" and fits nicely with Kubernetes' nautical theme.",{"title":342,"searchDepth":343,"depth":343,"links":344},"",2,[345,346,347],{"id":285,"depth":343,"text":286},{"id":292,"depth":343,"text":293},{"id":336,"depth":343,"text":337},"Overview of Gefyra's building blocks — CLI, Cargo, Stowaway, Operator, and Carrier2 — and how they connect local Docker or Podman containers to Kubernetes.","md",null,{},{"icon":180},{"title":177,"description":348},"GCqxIz9ooVpUhO87szyai0AawHxcVLCbvOLEVBDTI9k",[356,358],{"title":168,"path":173,"stem":174,"description":357,"icon":175,"children":-1},"Architecture overview of Gefyra's WireGuard tunnel, Cargo sidecar, Stowaway gateway, Operator, and Carrier2 proxy — how local containers join a live Kubernetes cluster.",{"title":187,"path":188,"stem":189,"description":359,"icon":190,"children":-1},"An objective, in-depth architectural comparison between Gefyra and Telepresence. Learn why teams choose Gefyra for Docker-native isolation and 100% open-source licensing.",1795114695530]