[{"data":1,"prerenderedAt":574},["ShallowReactive",2],{"navigation_docs_en":3,"-en-comparisons-gefyra-vs-telepresence":225,"-en-comparisons-gefyra-vs-telepresence-surround":569},[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":562,"extension":563,"links":564,"meta":565,"navigation":566,"path":188,"seo":567,"stem":189,"__hash__":568},"docs_en\u002Fen\u002F7.comparisons\u002F1.gefyra-vs-telepresence.md","Gefyra vs. Telepresence: Open Source Kubernetes Development Compared",{"type":229,"value":230,"toc":549},"minimark",[231,240,247,250,255,409,411,415,420,446,451,453,457,476,478,482,497,499,503,515,517,521,524],[232,233,234,235,239],"p",{},"When modern engineering teams seek to bridge their local machines into remote Kubernetes clusters, ",[236,237,238],"strong",{},"Telepresence"," (developed by Ambassador Labs) is one of the most widely known tools.",[232,241,242,243,246],{},"However, Telepresence and Gefyra are built on fundamentally different architectural philosophies. While Telepresence intercepts host OS network traffic and requires commercial cloud accounts for team features, ",[236,244,245],{},"Gefyra is 100% open source and keeps all networking strictly isolated inside your local container runtime",".",[248,249],"hr",{},[251,252,254],"h2",{"id":253},"architectural-comparison-matrix","Architectural Comparison Matrix",[256,257,258,276],"table",{},[259,260,261],"thead",{},[262,263,264,269,273],"tr",{},[265,266,268],"th",{"align":267},"left","Dimension",[265,270,272],{"align":271},"center","Gefyra",[265,274,275],{"align":271},"Telepresence (v2)",[277,278,279,295,315,330,349,364,379,394],"tbody",{},[262,280,281,287,292],{},[282,283,284],"td",{"align":267},[236,285,286],{},"Open Source Licensing",[282,288,289],{"align":271},[236,290,291],{},"100% Apache 2.0 (Zero Paywalls)",[282,293,294],{"align":271},"Proprietary Core \u002F Freemium SaaS",[262,296,297,302,307],{},[282,298,299],{"align":267},[236,300,301],{},"Local Host Modification",[282,303,304],{"align":271},[236,305,306],{},"None (Isolated in Docker\u002FPodman)",[282,308,309,310,314],{"align":271},"Modifies host ",[311,312,313],"code",{},"\u002Fetc\u002Fresolv.conf"," & routing tables",[262,316,317,322,327],{},[282,318,319],{"align":267},[236,320,321],{},"Local Runtime",[282,323,324],{"align":271},[236,325,326],{},"Native Docker or Podman Container",[282,328,329],{"align":271},"Raw host process (macOS \u002F Linux \u002F Windows)",[262,331,332,337,342],{},[282,333,334],{"align":267},[236,335,336],{},"Root \u002F Sudo Privileges",[282,338,339],{"align":271},[236,340,341],{},"Zero Sudo (Runs Rootless with Podman)",[282,343,344,345,348],{"align":271},"Requires ",[311,346,347],{},"sudo"," to alter host network stack",[262,350,351,356,361],{},[282,352,353],{"align":267},[236,354,355],{},"Cluster Footprint",[282,357,358],{"align":271},[236,359,360],{},"Lightweight Operator & Stowaway Gateway",[282,362,363],{"align":271},"Heavy Traffic Manager Daemon + Injected Agents",[262,365,366,371,376],{},[282,367,368],{"align":267},[236,369,370],{},"Team Sharing in Staging",[282,372,373],{"align":271},[236,374,375],{},"Included (User-Specific Bridges)",[282,377,378],{"align":271},"Paywalled (Requires Ambassador Cloud account)",[262,380,381,386,391],{},[282,382,383],{"align":267},[236,384,385],{},"AI Agent Runtime Context",[282,387,388],{"align":271},[236,389,390],{},"Native (Full Container & Tooling Access)",[282,392,393],{"align":271},"Partial (Tied to host environment)",[262,395,396,401,406],{},[282,397,398],{"align":267},[236,399,400],{},"VPN Technology",[282,402,403],{"align":271},[236,404,405],{},"WireGuard (Fast, Modern, Encrypted)",[282,407,408],{"align":271},"Custom TUN device & SOCKS5 proxy",[248,410],{},[251,412,414],{"id":413},"deep-dive-core-differences","Deep Dive: Core Differences",[416,417,419],"h3",{"id":418},"_1-no-host-machine-pollution","1. No Host Machine Pollution",[421,422,423,433],"ul",{},[424,425,426,429,430,432],"li",{},[236,427,428],{},"Telepresence:"," Injects a virtual TUN interface into your host operating system and dynamically modifies your host DNS configuration (",[311,431,313],{}," on Linux\u002FmacOS) and IP routing tables. If Telepresence crashes or loses connection, your entire laptop's internet routing and corporate VPN connections can deadlock.",[424,434,435,438,439,441,442,445],{},[236,436,437],{},"Gefyra:"," Does not alter your host routing tables or ",[311,440,313],{},". All cluster network routing, DNS overrides, and WireGuard interfaces are contained inside an isolated local Docker or Podman container (",[236,443,444],{},"Cargo","). Your host machine remains completely untouched.",[447,448],"content-mermaid-transport",{":page-data":449,"code":450},"runtimeData","flowchart%20TD%0A%20%20%20%20subgraph%20TelepresenceModel%0A%20%20%20%20%20%20%20%20direction%20LR%0A%20%20%20%20%20%20%20%20TeleTitle%5B%5B%22Telepresence%3A%20Host%20OS%20Inject%22%5D%5D%20~~~%20HostApp%5B%22Host%20Process%22%5D%0A%20%20%20%20%20%20%20%20HostApp%20--%3E%20HostNet%5B%22Host%20OS%20Routing%20%26%20%2Fetc%2Fresolv.conf%20(Sudo)%20%E2%9A%A0%EF%B8%8F%22%5D%0A%20%20%20%20%20%20%20%20HostNet%20--%3E%20TUN%5B%22Virtual%20TUN%20Device%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%20Isolated%20Containers%22%5D%5D%20~~~%20AppContainer%5B%22Local%20Container%22%5D%0A%20%20%20%20%20%20%20%20AppContainer%20--%3E%20CargoContainer%5B%22Gefyra%20Cargo%20Container%20(Isolated)%20%F0%9F%9B%A1%EF%B8%8F%22%5D%0A%20%20%20%20%20%20%20%20CargoContainer%20--%3E%20HostClean%5B%22Host%20OS%20(Untouched%20%2F%20Zero%20Sudo)%22%5D%0A%20%20%20%20end%0A%0A%20%20%20%20classDef%20groupTitle%20fill%3Atransparent%2Cstroke%3Anone%3B%0A%20%20%20%20classDef%20danger%20stroke-width%3A2px%3B%0A%20%20%20%20classDef%20safe%20stroke-width%3A2px%3B%0A%20%20%20%20class%20TeleTitle%2CGefyraTitle%20groupTitle%3B%0A%20%20%20%20class%20TelepresenceModel%20danger%3B%0A%20%20%20%20class%20GefyraModel%20safe%3B",[248,452],{},[416,454,456],{"id":455},"_2-100-open-source-vs-commercial-saas-gatekeeping","2. 100% Open Source vs. Commercial SaaS Gatekeeping",[421,458,459,467],{},[424,460,461,463,464,246],{},[236,462,428],{}," While basic personal interception is free, multi-developer collaboration, team preview URLs, and advanced interception features require an ",[236,465,466],{},"Ambassador Cloud commercial account",[424,468,469,471,472,475],{},[236,470,437],{}," ",[236,473,474],{},"100% Free and Open Source (Apache 2.0)",". Team scaling, namespace isolation, User-Specific Bridges, and full operator functionality are included out of the box with zero commercial licenses, tracking, or cloud account lock-in.",[248,477],{},[416,479,481],{"id":480},"_3-native-docker-podman-environments","3. Native Docker & Podman Environments",[421,483,484,489],{},[424,485,486,488],{},[236,487,428],{}," Runs your service as a raw process on your local laptop. If your service requires specific C-libraries, system packages, or environment configurations, you must manually install them on your host OS.",[424,490,491,493,494,246],{},[236,492,437],{}," Runs your service inside a container identical to your production image. If your workload runs in Docker, it runs flawlessly in Gefyra—even with daemonless and rootless engines like ",[236,495,496],{},"Podman",[248,498],{},[416,500,502],{"id":501},"_4-grounding-autonomous-ai-coding-agents","4. Grounding Autonomous AI Coding Agents",[421,504,505,510],{},[424,506,507,509],{},[236,508,428],{}," Because it operates via host networking, AI agents running in sandboxed IDEs (e.g., Cursor, Claude Code) may experience proxy leakage or struggle to bind host ports correctly when concurrent tunnels are open.",[424,511,512,514],{},[236,513,437],{}," The AI agent operates in a native containerized workspace. It can run in-cluster unit tests, curl live staging endpoints, and query cluster databases without interfering with host applications or corporate VPNs.",[248,516],{},[251,518,520],{"id":519},"when-to-choose-gefyra","When to Choose Gefyra",[232,522,523],{},"Choose Gefyra if you:",[421,525,526,533,540,546],{},[424,527,528,529,532],{},"Want a ",[236,530,531],{},"100% open-source tool"," with zero paywalled team features.",[424,534,535,536,539],{},"Prefer ",[236,537,538],{},"Docker or Podman"," container workflows over running raw processes on your host.",[424,541,542,543,246],{},"Work under strict corporate security policies that ",[236,544,545],{},"prohibit sudo or host network modification",[424,547,548],{},"Want a fast, low-friction tool that won't brick your laptop's Wi-Fi or VPN connection when disconnected.",{"title":550,"searchDepth":551,"depth":551,"links":552},"",2,[553,554,561],{"id":253,"depth":551,"text":254},{"id":413,"depth":551,"text":414,"children":555},[556,558,559,560],{"id":418,"depth":557,"text":419},3,{"id":455,"depth":557,"text":456},{"id":480,"depth":557,"text":481},{"id":501,"depth":557,"text":502},{"id":519,"depth":551,"text":520},"An objective, in-depth architectural comparison between Gefyra and Telepresence. Learn why teams choose Gefyra for Docker-native isolation and 100% open-source licensing.","md",null,{},{"title":187,"icon":190},{"title":227,"description":562},"SPCojyR9TW5qUFrBNkdRr7XpuaUcbT9Rsd3VOdVe3Gc",[570,572],{"title":177,"path":178,"stem":179,"description":571,"icon":180,"children":-1},"Overview of Gefyra's building blocks — CLI, Cargo, Stowaway, Operator, and Carrier2 — and how they connect local Docker or Podman containers to Kubernetes.",{"title":192,"path":193,"stem":194,"description":573,"icon":190,"children":-1},"Compare Gefyra and mirrord. Explore the technical differences between dynamic linker hooking (LD_PRELOAD) and container-native network overlays (WireGuard).",1795114695598]