[{"data":1,"prerenderedAt":643},["ShallowReactive",2],{"navigation_docs_en":3,"-en-comparisons-gefyra-vs-mirrord":225,"-en-comparisons-gefyra-vs-mirrord-surround":638},[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":631,"extension":632,"links":633,"meta":634,"navigation":635,"path":193,"seo":636,"stem":194,"__hash__":637},"docs_en\u002Fen\u002F7.comparisons\u002F2.gefyra-vs-mirrord.md","Gefyra vs. mirrord: Hook-Based vs. Container-Native Kubernetes Development",{"type":229,"value":230,"toc":619},"minimark",[231,244,255,258,263,415,417,421,426,476,481,483,487,501,503,507,526,528,532],[232,233,234,235,239,240,243],"p",{},"Both ",[236,237,238],"strong",{},"Gefyra"," and ",[236,241,242],{},"mirrord"," (developed by MetalBear) solve the inner-loop Kubernetes problem by connecting local code to remote staging clusters without requiring container builds and pushes.",[232,245,246,247,250,251,254],{},"However, the underlying interception mechanisms are radically different: ",[236,248,249],{},"mirrord intercepts OS-level system calls via dynamic library injection",", while ",[236,252,253],{},"Gefyra overlays container network traffic using WireGuard and native container engines",".",[256,257],"hr",{},[259,260,262],"h2",{"id":261},"architectural-comparison-matrix","Architectural Comparison Matrix",[264,265,266,282],"table",{},[267,268,269],"thead",{},[270,271,272,277,280],"tr",{},[273,274,276],"th",{"align":275},"left","Dimension",[273,278,238],{"align":279},"center",[273,281,242],{"align":279},[283,284,285,310,325,340,355,370,385,400],"tbody",{},[270,286,287,293,298],{},[288,289,290],"td",{"align":275},[236,291,292],{},"Interception Method",[288,294,295],{"align":279},[236,296,297],{},"Network Overlay (WireGuard + Carrier2)",[288,299,300,301,305,306,309],{"align":279},"System Call Hooking (",[302,303,304],"code",{},"LD_PRELOAD"," \u002F ",[302,307,308],{},"DYLD_INSERT_LIBRARIES",")",[270,311,312,317,322],{},[288,313,314],{"align":275},[236,315,316],{},"Local Runtime",[288,318,319],{"align":279},[236,320,321],{},"Native Docker or Podman Container",[288,323,324],{"align":279},"Raw local host process or IDE plugin",[270,326,327,332,337],{},[288,328,329],{"align":275},[236,330,331],{},"Language & Binary Support",[288,333,334],{"align":279},[236,335,336],{},"100% Universal (Any container image)",[288,338,339],{"align":279},"Limited on statically linked binaries (Go without CGO, Rust, musl)",[270,341,342,347,352],{},[288,343,344],{"align":275},[236,345,346],{},"Operating System Support",[288,348,349],{"align":279},[236,350,351],{},"Linux, macOS, Windows (WSL2)",[288,353,354],{"align":279},"Linux, macOS (Requires disabling SIP on certain binaries)",[270,356,357,362,367],{},[288,358,359],{"align":275},[236,360,361],{},"Container Parity",[288,363,364],{"align":279},[236,365,366],{},"Identical to Production (Same image\u002Fenv)",[288,368,369],{"align":279},"Runs in local host environment with mocked syscalls",[270,371,372,377,382],{},[288,373,374],{"align":275},[236,375,376],{},"Cluster Component",[288,378,379],{"align":279},[236,380,381],{},"Lightweight Operator & Stowaway Gateway",[288,383,384],{"align":279},"Ephemeral agent jobs spawned per debug session",[270,386,387,392,397],{},[288,388,389],{"align":275},[236,390,391],{},"Traffic Direction",[288,393,394],{"align":279},[236,395,396],{},"Bidirectional Intercept & Route",[288,398,399],{"align":279},"Mirror (Duplicate) or Steal (Intercept)",[270,401,402,407,412],{},[288,403,404],{"align":275},[236,405,406],{},"Licensing",[288,408,409],{"align":279},[236,410,411],{},"100% Open Source (Apache 2.0)",[288,413,414],{"align":279},"Open-Core \u002F Commercial Cloud Control Plane (MetalBear SaaS)",[256,416],{},[259,418,420],{"id":419},"deep-dive-core-technical-differences","Deep Dive: Core Technical Differences",[422,423,425],"h3",{"id":424},"_1-interception-mechanism-network-overlay-vs-syscall-hooking","1. Interception Mechanism: Network Overlay vs. Syscall Hooking",[427,428,429,470],"ul",{},[430,431,432,438,439,442,443,442,446,449,450],"li",{},[236,433,434,435,437],{},"mirrord (",[302,436,304],{},"):"," Injects a shared library into your local process. Whenever your application calls standard C library functions (like ",[302,440,441],{},"socket()",", ",[302,444,445],{},"connect()",[302,447,448],{},"open()","), mirrord intercepts the system call and forwards it to an agent pod in the cluster.\n",[427,451,452],{},[430,453,454,458,459,442,462,465,466,469],{},[455,456,457],"em",{},"Limitation:"," If your binary is statically compiled (standard in ",[236,460,461],{},"Go",[236,463,464],{},"Rust",", or Alpine ",[236,467,468],{},"musl"," libc), or if your operating system enforces strict code-signing (macOS System Integrity Protection), syscall hooking can fail or require complex compilation flags.",[430,471,472,475],{},[236,473,474],{},"Gefyra (WireGuard & Container Overlay):"," Operates at the network layer. Gefyra does not manipulate your application's binary or dynamic linker. It connects your container's network interface directly into the remote Kubernetes network fabric via an encrypted WireGuard tunnel. If it runs in a container, it runs in Gefyra—regardless of language, libc variant, or compiler settings.",[477,478],"content-mermaid-transport",{":page-data":479,"code":480},"runtimeData","flowchart%20TD%0A%20%20%20%20subgraph%20MirrordModel%0A%20%20%20%20%20%20%20%20direction%20LR%0A%20%20%20%20%20%20%20%20MirrordTitle%5B%5B%22mirrord%3A%20Linker%20Inject%22%5D%5D%20~~~%20LocalProcess%5B%22Local%20Binary%22%5D%0A%20%20%20%20%20%20%20%20LocalProcess%20--%3E%7CIntercepts%20Syscalls%7C%20HookLib%5B%22mirrord%20lib%20(LD_PRELOAD)%20%E2%9A%A0%EF%B8%8F%22%5D%0A%20%20%20%20%20%20%20%20HookLib%20--%3E%20AgentJob%5B%22Ephemeral%20K8s%20Agent%20Job%22%5D%0A%20%20%20%20end%0A%0A%20%20%20%20subgraph%20GefyraModel%0A%20%20%20%20%20%20%20%20direction%20LR%0A%20%20%20%20%20%20%20%20GefyraTitle%5B%5B%22Gefyra%3A%20Network%20Overlay%22%5D%5D%20~~~%20DockerContainer%5B%22Standard%20Docker%20Container%22%5D%0A%20%20%20%20%20%20%20%20DockerContainer%20--%3E%7CWireGuard%20UDP%7C%20StowawayGateway%5B%22Gefyra%20Operator%20%2F%20Stowaway%20%F0%9F%9B%A1%EF%B8%8F%22%5D%0A%20%20%20%20%20%20%20%20StowawayGateway%20--%3E%20RealPod%5B%22Live%20Staging%20Pod%22%5D%0A%20%20%20%20end%0A%0A%20%20%20%20classDef%20groupTitle%20fill%3Atransparent%2Cstroke%3Anone%3B%0A%20%20%20%20classDef%20hook%20stroke-width%3A2px%3B%0A%20%20%20%20classDef%20overlay%20stroke-width%3A2px%3B%0A%20%20%20%20class%20MirrordTitle%2CGefyraTitle%20groupTitle%3B%0A%20%20%20%20class%20MirrordModel%20hook%3B%0A%20%20%20%20class%20GefyraModel%20overlay%3B",[256,482],{},[422,484,486],{"id":485},"_2-environment-parity-the-works-on-my-machine-problem","2. Environment Parity (The \"Works on My Machine\" Problem)",[427,488,489,495],{},[430,490,491,494],{},[236,492,493],{},"mirrord:"," Because your application runs directly on your macOS or Linux host, environment variables, local system libraries, and filesystem paths are mixed between your laptop and the remote cluster.",[430,496,497,500],{},[236,498,499],{},"Gefyra:"," Your application runs inside an authentic Docker or Podman container. Filesystem mounts, environment variables, and Linux user permissions match your production Kubernetes manifest exactly.",[256,502],{},[422,504,506],{"id":505},"_3-open-source-model-enterprise-governance","3. Open Source Model & Enterprise Governance",[427,508,509,517],{},[430,510,511,513,514,254],{},[236,512,493],{}," Follows an open-core model where enterprise team features (centralized RBAC management, cluster usage policies, persistent team sessions) require ",[236,515,516],{},"MetalBear Cloud \u002F mirrord for Teams",[430,518,519,521,522,525],{},[236,520,499],{}," ",[236,523,524],{},"100% Apache 2.0 Open Source",". All operator capabilities, User-Specific Bridges, namespace isolation, and multi-developer support are freely available without commercial subscriptions.",[256,527],{},[259,529,531],{"id":530},"summary-which-tool-should-you-use","Summary: Which Tool Should You Use?",[264,533,534,547],{},[267,535,536],{},[270,537,538,541,544],{},[273,539,540],{"align":275},"Use Case",[273,542,543],{"align":279},"Best Choice",[273,545,546],{"align":275},"Why",[283,548,549,563,577,591,605],{},[270,550,551,556,560],{},[288,552,553],{"align":275},[236,554,555],{},"Container-Native Teams",[288,557,558],{"align":279},[236,559,238],{},[288,561,562],{"align":275},"You develop with Docker Compose, Docker Desktop, or Podman, and want 100% production container parity.",[270,564,565,570,574],{},[288,566,567],{"align":275},[236,568,569],{},"Statically Compiled Go \u002F Rust Microservices",[288,571,572],{"align":279},[236,573,238],{},[288,575,576],{"align":275},"Operates at the network layer and never fails due to static linking or macOS SIP restrictions.",[270,578,579,584,588],{},[288,580,581],{"align":275},[236,582,583],{},"Autonomous AI Coding Agents",[288,585,586],{"align":279},[236,587,238],{},[288,589,590],{"align":275},"AI agents need isolated container workspaces to run integration tests against real cluster endpoints.",[270,592,593,598,602],{},[288,594,595],{"align":275},[236,596,597],{},"Quick Local Process Prototyping",[288,599,600],{"align":279},[236,601,242],{},[288,603,604],{"align":275},"Good for running a single lightweight Python script on your host without opening Docker.",[270,606,607,612,616],{},[288,608,609],{"align":275},[236,610,611],{},"Strict Enterprise Zero-SaaS Compliance",[288,613,614],{"align":279},[236,615,238],{},[288,617,618],{"align":275},"Completely self-contained within your cluster; zero telemetry or external SaaS dependencies.",{"title":620,"searchDepth":621,"depth":621,"links":622},"",2,[623,624,630],{"id":261,"depth":621,"text":262},{"id":419,"depth":621,"text":420,"children":625},[626,628,629],{"id":424,"depth":627,"text":425},3,{"id":485,"depth":627,"text":486},{"id":505,"depth":627,"text":506},{"id":530,"depth":621,"text":531},"Compare Gefyra and mirrord. Explore the technical differences between dynamic linker hooking (LD_PRELOAD) and container-native network overlays (WireGuard).","md",null,{},{"title":192,"icon":190},{"title":227,"description":631},"TYlLPoSWOQhXI67_rvk3QwQW1qM_Ju6g8aD3HO5J2bI",[639,641],{"title":187,"path":188,"stem":189,"description":640,"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.",{"title":201,"path":202,"stem":203,"description":642,"icon":204,"children":-1},"Gefyra's CLI allows you to run containers on your local machine and connect them to Kubernetes-based resources.",1795114695664]