[{"data":1,"prerenderedAt":661},["ShallowReactive",2],{"navigation_docs_en":3,"-en-cluster-guides-overview":225,"-en-cluster-guides-overview-surround":656},[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":227,"body":228,"description":649,"extension":650,"links":651,"meta":652,"navigation":653,"path":118,"seo":654,"stem":119,"__hash__":655},"docs_en\u002Fen\u002F5.cluster-guides\u002F1.overview.md","Kubernetes Cluster Compatibility & Deployment Overview",{"type":229,"value":230,"toc":640},"minimark",[231,240,247,250,255,260,395,397,401,509,511,515,529,563,598,604,606,610,636],[232,233,234,235,239],"p",{},"Gefyra is engineered to run against ",[236,237,238],"strong",{},"any standard Kubernetes cluster (v1.24+)",", whether running locally on your laptop or hosted in enterprise cloud environments.",[232,241,242,243,246],{},"Because Gefyra operates purely at the container network and user-space operator level, it requires ",[236,244,245],{},"no proprietary kernel modules"," or invasive cluster-wide service meshes (like Istio or Linkerd).",[248,249],"hr",{},[251,252,254],"h2",{"id":253},"compatibility-matrix","Compatibility Matrix",[256,257,259],"h3",{"id":258},"local-development-clusters","Local Development Clusters",[261,262,263,284],"table",{},[264,265,266],"thead",{},[267,268,269,274,277,281],"tr",{},[270,271,273],"th",{"align":272},"left","Platform",[270,275,276],{"align":272},"Driver \u002F Runtime",[270,278,280],{"align":279},"center","Status",[270,282,283],{"align":272},"Key Characteristics",[285,286,287,308,331,357,376],"tbody",{},[267,288,289,297,300,305],{},[290,291,292],"td",{"align":272},[236,293,294],{},[295,296,105],"a",{"href":106},[290,298,299],{"align":272},"Docker \u002F Podman",[290,301,302],{"align":279},[236,303,304],{},"Recommended",[290,306,307],{"align":272},"Blazingly fast startup; automated port exposure via Docker bridge network.",[267,309,310,316,318,323],{},[290,311,312],{"align":272},[236,313,314],{},[295,315,109],{"href":110},[290,317,299],{"align":272},[290,319,320],{"align":279},[236,321,322],{},"Full",[290,324,325,326,330],{"align":272},"Standard CNCF conformance engine; NodePort mapping via ",[327,328,329],"code",{},"extraPortMappings",".",[267,332,333,339,342,346],{},[290,334,335],{"align":272},[236,336,337],{},[295,338,113],{"href":114},[290,340,341],{"align":272},"Docker, Hyperkit, KVM",[290,343,344],{"align":279},[236,345,322],{},[290,347,348,349,352,353,356],{"align":272},"Classic local cluster; requires ",[327,350,351],{},"minikube ip"," or ",[327,354,355],{},"minikube service"," for endpoint reachability.",[267,358,359,366,369,373],{},[290,360,361],{"align":272},[236,362,363],{},[295,364,365],{"href":97},"Colima",[290,367,368],{"align":272},"QEMU \u002F Lima (macOS)",[290,370,371],{"align":279},[236,372,322],{},[290,374,375],{"align":272},"Lightweight, Docker Desktop-free container runtime with native Kubernetes.",[267,377,378,385,388,392],{},[290,379,380],{"align":272},[236,381,382],{},[295,383,384],{"href":102},"Docker Desktop",[290,386,387],{"align":272},"Virtual Machine",[290,389,390],{"align":279},[236,391,322],{},[290,393,394],{"align":272},"Built-in single-node Kubernetes; supports native Docker Desktop Extension.",[248,396],{},[256,398,400],{"id":399},"managed-cloud-kubernetes-providers","Managed Cloud Kubernetes Providers",[261,402,403,418],{},[264,404,405],{},[267,406,407,410,413,415],{},[270,408,409],{"align":272},"Cloud Provider",[270,411,412],{"align":272},"Service",[270,414,280],{"align":279},[270,416,417],{"align":272},"Connection Method",[285,419,420,438,457,475,492],{},[267,421,422,429,431,435],{},[290,423,424],{"align":272},[236,425,426],{},[295,427,428],{"href":133},"Amazon Web Services",[290,430,132],{"align":272},[290,432,433],{"align":279},[236,434,322],{},[290,436,437],{"align":272},"NLB (Network Load Balancer) or NodePort with Security Group opening on UDP 31820.",[267,439,440,447,450,454],{},[290,441,442],{"align":272},[236,443,444],{},[295,445,446],{"href":128},"Google Cloud Platform",[290,448,449],{"align":272},"Google Kubernetes Engine (GKE)",[290,451,452],{"align":279},[236,453,322],{},[290,455,456],{"align":272},"Standard or Autopilot with Cloud Firewall rule allowing UDP 31820.",[267,458,459,465,468,472],{},[290,460,461],{"align":272},[236,462,463],{},[295,464,137],{"href":138},[290,466,467],{"align":272},"European Managed K8s",[290,469,470],{"align":279},[236,471,322],{},[290,473,474],{"align":272},"OpenStack \u002F Octavia LoadBalancer endpoint.",[267,476,477,482,485,489],{},[290,478,479],{"align":272},[236,480,481],{},"Microsoft Azure",[290,483,484],{"align":272},"Azure Kubernetes Service (AKS)",[290,486,487],{"align":279},[236,488,322],{},[290,490,491],{"align":272},"Azure Public IP LoadBalancer on port 31820.",[267,493,494,499,502,506],{},[290,495,496],{"align":272},[236,497,498],{},"Self-Hosted \u002F On-Premise",[290,500,501],{"align":272},"RKE2, kubeadm, Talos",[290,503,504],{"align":279},[236,505,322],{},[290,507,508],{"align":272},"Standard NodePort or MetalLB BGP configuration.",[248,510],{},[251,512,514],{"id":513},"network-prerequisites-the-stowaway-wireguard-port","Network Prerequisites: The Stowaway WireGuard Port",[232,516,517,518,352,521,524,525,528],{},"When Gefyra installs its operator (",[327,519,520],{},"gefyra up",[327,522,523],{},"gefyra install","), it deploys the ",[236,526,527],{},"Stowaway"," gateway component. Stowaway establishes the encrypted WireGuard link with local developer machines.",[530,531,532,542,550],"ul",{},[533,534,535,538,539],"li",{},[236,536,537],{},"Protocol:"," ",[327,540,541],{},"UDP",[533,543,544,538,547],{},[236,545,546],{},"Default Port:",[327,548,549],{},"31820",[533,551,552,538,555,558,559,562],{},[236,553,554],{},"Service Type:",[327,556,557],{},"NodePort"," (default for local clusters) or ",[327,560,561],{},"LoadBalancer"," (common for cloud providers)",[564,565,570],"pre",{"className":566,"code":567,"language":568,"meta":569,"style":569},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Example: Install Gefyra with LoadBalancer service type for Cloud EKS\u002FGKE\ngefyra install --service-type LoadBalancer\n","bash","",[327,571,572,581],{"__ignoreMap":569},[573,574,577],"span",{"class":575,"line":576},"line",1,[573,578,580],{"class":579},"sHwdD","# Example: Install Gefyra with LoadBalancer service type for Cloud EKS\u002FGKE\n",[573,582,584,588,592,595],{"class":575,"line":583},2,[573,585,587],{"class":586},"sBMFI","gefyra",[573,589,591],{"class":590},"sfazB"," install",[573,593,594],{"class":590}," --service-type",[573,596,597],{"class":590}," LoadBalancer\n",[232,599,600,601,603],{},"If your cluster sits behind a corporate firewall or cloud security group (e.g., AWS Security Group or GCP VPC Firewall), ensure that inbound UDP traffic on port ",[327,602,549],{}," is permitted to worker nodes.",[248,605],{},[251,607,609],{"id":608},"choosing-the-right-cluster-for-your-workflow","Choosing the Right Cluster for Your Workflow",[611,612,613,624],"card-group",{},[614,615,618,619,352,621,623],"card",{"icon":616,"title":617},"i-lucide-laptop","Solo Local Fast-Feedback","Use ",[236,620,105],{},[236,622,109],{},". Both spin up in seconds and allow you to test Gefyra bridges offline without an active internet connection.",[614,625,628,629,352,632,635],{"icon":626,"title":627},"i-lucide-users","Team Shared Staging","Use a shared ",[236,630,631],{},"AWS EKS",[236,633,634],{},"GCP GKE"," staging cluster. Deploy Gefyra once with an external LoadBalancer service, and issue isolated client credentials to team members.",[637,638,639],"style",{},"html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":569,"searchDepth":583,"depth":583,"links":641},[642,647,648],{"id":253,"depth":583,"text":254,"children":643},[644,646],{"id":258,"depth":645,"text":259},3,{"id":399,"depth":645,"text":400},{"id":513,"depth":583,"text":514},{"id":608,"depth":583,"text":609},"Connect Gefyra to any Kubernetes cluster. Compatibility guides for local engines (k3d, kind, minikube, Docker Desktop, Colima) and remote clouds (EKS, GKE, AKS).","md",null,{},{"title":117,"icon":120},{"title":227,"description":649},"HBUc8Gn9IjNgFMEzjyfrf32-V9tVIxMa2Ken27-f2pQ",[657,659],{"title":113,"path":114,"stem":115,"description":658,"icon":99,"children":-1},"Step-by-step guide to running Gefyra on Minikube. Connect your local Docker containers and IDE directly into your local Minikube cluster.",{"title":127,"path":128,"stem":129,"description":660,"icon":130,"children":-1},"Bridge local containers into a remote GKE cluster with Gefyra — WireGuard over UDP 31820, firewall rules, and live staging development.",1795114692427]