[{"data":1,"prerenderedAt":425},["ShallowReactive",2],{"navigation_docs_en":3,"-en-quickstart-docker-desktop-extension":225,"-en-quickstart-docker-desktop-extension-surround":420},[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":21,"body":227,"description":413,"extension":414,"links":415,"meta":416,"navigation":417,"path":22,"seo":418,"stem":23,"__hash__":419},"docs_en\u002Fen\u002F1.quickstart\u002F4.docker-desktop-extension.md",{"type":228,"value":229,"toc":407},"minimark",[230,242,246,256,260,269,272,301,305,315,322,325,331,342,348,380,386,389,392,396,400,403],[231,232,233,241],"p",{},[234,235,240],"a",{"href":236,"rel":237,"target":239},"https:\u002F\u002Fhub.docker.com\u002Fr\u002Fgefyra\u002Fdocker-desktop-extension",[238],"nofollow","_blank","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.",[243,244,245],"note",{},"Gefyra's Docker Desktop Extension still runs Gefyra v1 internally and thus does not support shared environments.",[231,247,248,252,253],{},[249,250,251],"strong",{},"Looking for CLI rather than a GUI?"," Check out ",[234,254,255],{"href":202},"Gefyra's CLI",[257,258,12],"h2",{"id":259},"installation",[231,261,262,263,268],{},"The Gefyra Docker Desktop Extension is available on the Docker Desktop extension ",[234,264,267],{"href":265,"rel":266,"target":239},"https:\u002F\u002Fhub.docker.com\u002Fextensions\u002Fgefyra\u002Fdocker-desktop-extension",[238],"marketplace",".",[231,270,271],{},"However, you can also install it by running the following command:",[273,274,279],"pre",{"className":275,"code":276,"language":277,"meta":278,"style":278},"language-shell shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","docker extension install gefyra\u002Fdocker-desktop-extension:latest\n","shell","",[280,281,282],"code",{"__ignoreMap":278},[283,284,287,291,295,298],"span",{"class":285,"line":286},"line",1,[283,288,290],{"class":289},"sBMFI","docker",[283,292,294],{"class":293},"sfazB"," extension",[283,296,297],{"class":293}," install",[283,299,300],{"class":293}," gefyra\u002Fdocker-desktop-extension:latest\n",[257,302,304],{"id":303},"usage","Usage",[231,306,307,308,311,312,314],{},"After installing the extension it becomes available in the Docker Desktop Extension sidebar. Gefyra Docker Desktop currently only supports the ",[280,309,310],{},"run"," mode. After clicking on the ",[280,313,310],{}," tile you're guided through the process of running a container on your local machine.",[231,316,317],{},[318,319],"img",{"alt":320,"src":321},"Docker Desktop Extension Start","\u002Fimg\u002Fextension\u002Fhome_light.png",[231,323,324],{},"Firstly Gefyra needs to know about your cluster to allow you to set all settings accordingly.",[231,326,327],{},[318,328],{"alt":329,"src":330},"Docker Desktop Extension Cluster Settings","\u002Fimg\u002Fextension\u002Fcluster_light.png",[231,332,333,334,338,339,268],{},"After choosing your ",[335,336,337],"em",{},"kubeconfig"," and context you can then proceed to adding the settings for your container. In case you have a remote cluster\nyou need to provide Gefyra with its connection parameters under ",[280,340,341],{},"Remote Cluster Settings",[231,343,344],{},[318,345],{"alt":346,"src":347},"Docker Desktop Extension Container Settings","\u002Fimg\u002Fextension\u002Fcontainer_light.png",[231,349,350,351,354,355,358,359,362,363,365,366,368,369,372,373,358,376,379],{},"There are several settings for the container - most importantly the ",[280,352,353],{},"image",", ",[280,356,357],{},"namespace"," and ",[280,360,361],{},"command"," settings.\nThe ",[280,364,353],{}," setting is the image that will be used to run the container - Gefyra will you show any image that is available in the local Docker Desktop context as\nwell as images that are available in the chosen Kubernetes namespace. The ",[280,367,357],{}," setting is the namespace in which the container will be available.\nGefyra allows you to copy the environment variables of a certain workload through the ",[280,370,371],{},"Copy Environment From"," dropdown.\nYou can add volumes and more variables through the ",[280,374,375],{},"Add Volume",[280,377,378],{},"Add Environment Variable"," buttons.\nAs soon as you're done hit run!",[231,381,382],{},[318,383],{"alt":384,"src":385},"Docker Desktop Extension Load","\u002Fimg\u002Fextension\u002Fload_light.png",[231,387,388],{},"Gefyra ensures that its cluster components are in the correct state and starts the container.",[231,390,391],{},"Once the container is running Gefyra will show you the logs of the container.",[257,393,395],{"id":394},"_10-minute-demo","10 minute demo",[397,398],"gefyra-youtube",{"video-id":399},"4xmaOVul5Ww",[397,401],{"video-id":402},"EBArR1O2BGk",[404,405,406],"style",{},"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":278,"searchDepth":408,"depth":408,"links":409},2,[410,411,412],{"id":259,"depth":408,"text":12},{"id":303,"depth":408,"text":304},{"id":394,"depth":408,"text":395},"Install the Gefyra Docker Desktop Extension to bridge local containers into Kubernetes from a GUI — ideal for testing services without the CLI.","md",null,{},{"icon":24},{"title":21,"description":413},"qsH_xCyD1CdsctzF9tfdGK4gzvTRWZ7gL57IJXTcD_Q",[421,423],{"title":17,"path":18,"stem":19,"description":422,"icon":10,"children":-1},"Bridge a live Kubernetes service to your local container on Minikube — the hands-on follow-up to the 2-minute quickstart.",{"title":31,"path":32,"stem":33,"description":424,"icon":34,"children":-1},"Learn how to provide local AI coding agents like Cursor, Claude Code, and Gemini CLI with real-time Kubernetes cluster state using Gefyra.",1795114693788]