[{"data":1,"prerenderedAt":1184},["ShallowReactive",2],{"navigation_docs_en":3,"-en-quickstart":225,"-en-quickstart-surround":1181},[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":1174,"extension":1175,"links":1176,"meta":1177,"navigation":1178,"path":6,"seo":1179,"stem":7,"__hash__":1180},"docs_en\u002Fen\u002F1.quickstart\u002F1.index.md","The 2-Minute Quickstart",{"type":229,"value":230,"toc":1161},"minimark",[231,239,250,253,258,261,338,341,354,356,360,367,375,467,470,485,487,491,494,548,551,571,573,577,580,592,595,620,622,626,632,757,764,766,770,773,861,863,867,870,907,912,942,947,950,970,973,1001,1005,1027,1030,1032,1036,1039,1113,1119,1134,1136,1140,1157],[232,233,234,235],"p",{},"Ship verified code directly inside a live Kubernetes environment in under two minutes. ",[236,237,238],"strong",{},"Zero external dependencies, zero image builds, and zero registry pushes.",[232,240,241,242,245,246,249],{},"All you need is ",[236,243,244],{},"Docker"," or ",[236,247,248],{},"Podman"," running on your laptop.",[251,252],"hr",{},[254,255,257],"h2",{"id":256},"step-1-install-the-gefyra-cli-15-seconds","Step 1: Install the Gefyra CLI (15 Seconds)",[232,259,260],{},"Install the standalone Gefyra binary:",[262,263,264,298,326],"code-group",{},[265,266,272],"pre",{"className":267,"code":268,"filename":269,"language":270,"meta":271,"style":271},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fgefyrahq\u002Fgefyra\u002Fmain\u002Finstall.sh | sh\n","Linux \u002F macOS (One-Liner)","bash","",[273,274,275],"code",{"__ignoreMap":271},[276,277,280,284,288,291,295],"span",{"class":278,"line":279},"line",1,[276,281,283],{"class":282},"sBMFI","curl",[276,285,287],{"class":286},"sfazB"," -sSL",[276,289,290],{"class":286}," https:\u002F\u002Fraw.githubusercontent.com\u002Fgefyrahq\u002Fgefyra\u002Fmain\u002Finstall.sh",[276,292,294],{"class":293},"sMK4o"," |",[276,296,297],{"class":282}," sh\n",[265,299,302],{"className":267,"code":300,"filename":301,"language":270,"meta":271,"style":271},"brew tap gefyrahq\u002Fgefyra\nbrew install gefyra\n","Homebrew (macOS \u002F Linux)",[273,303,304,315],{"__ignoreMap":271},[276,305,306,309,312],{"class":278,"line":279},[276,307,308],{"class":282},"brew",[276,310,311],{"class":286}," tap",[276,313,314],{"class":286}," gefyrahq\u002Fgefyra\n",[276,316,318,320,323],{"class":278,"line":317},2,[276,319,308],{"class":282},[276,321,322],{"class":286}," install",[276,324,325],{"class":286}," gefyra\n",[265,327,332],{"className":328,"code":329,"filename":330,"language":331,"meta":271,"style":271},"language-powershell shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","iwr -useb https:\u002F\u002Fraw.githubusercontent.com\u002Fgefyrahq\u002Fgefyra\u002Fmain\u002Finstall.ps1 | iex\n","Windows (PowerShell)","powershell",[273,333,334],{"__ignoreMap":271},[276,335,336],{"class":278,"line":279},[276,337,329],{},[232,339,340],{},"Verify the CLI is ready:",[265,342,344],{"className":267,"code":343,"language":270,"meta":271,"style":271},"gefyra version\n",[273,345,346],{"__ignoreMap":271},[276,347,348,351],{"class":278,"line":279},[276,349,350],{"class":282},"gefyra",[276,352,353],{"class":286}," version\n",[251,355],{},[254,357,359],{"id":358},"step-2-spin-up-a-local-cluster-30-seconds","Step 2: Spin Up a Local Cluster (30 Seconds)",[232,361,362,363,366],{},"If you already have a Kubernetes cluster running, make sure your ",[273,364,365],{},"kubectl"," context is set and proceed to Step 3.",[232,368,369,370,245,372,374],{},"If you don't have a cluster yet, spin one up in seconds with ",[236,371,105],{},[236,373,113],{},":",[262,376,377,449],{},[265,378,381],{"className":267,"code":379,"filename":380,"language":270,"meta":271,"style":271},"# 1. Install k3d (if not already installed)\ncurl -s https:\u002F\u002Fraw.githubusercontent.com\u002Fk3d-io\u002Fk3d\u002Fmain\u002Finstall.sh | bash\n\n# 2. Create a lightweight cluster with the Gefyra WireGuard port exposed\nk3d cluster create gefyra --agents 1 -p 8080:80@agent:0 -p 31820:31820\u002FUDP@agent:0\n","k3d (Recommended)",[273,382,383,389,404,411,417],{"__ignoreMap":271},[276,384,385],{"class":278,"line":279},[276,386,388],{"class":387},"sHwdD","# 1. Install k3d (if not already installed)\n",[276,390,391,393,396,399,401],{"class":278,"line":317},[276,392,283],{"class":282},[276,394,395],{"class":286}," -s",[276,397,398],{"class":286}," https:\u002F\u002Fraw.githubusercontent.com\u002Fk3d-io\u002Fk3d\u002Fmain\u002Finstall.sh",[276,400,294],{"class":293},[276,402,403],{"class":282}," bash\n",[276,405,407],{"class":278,"line":406},3,[276,408,410],{"emptyLinePlaceholder":409},true,"\n",[276,412,414],{"class":278,"line":413},4,[276,415,416],{"class":387},"# 2. Create a lightweight cluster with the Gefyra WireGuard port exposed\n",[276,418,420,422,425,428,431,434,438,441,444,446],{"class":278,"line":419},5,[276,421,105],{"class":282},[276,423,424],{"class":286}," cluster",[276,426,427],{"class":286}," create",[276,429,430],{"class":286}," gefyra",[276,432,433],{"class":286}," --agents",[276,435,437],{"class":436},"sbssI"," 1",[276,439,440],{"class":286}," -p",[276,442,443],{"class":286}," 8080:80@agent:0",[276,445,440],{"class":286},[276,447,448],{"class":286}," 31820:31820\u002FUDP@agent:0\n",[265,450,453],{"className":267,"code":451,"filename":452,"language":270,"meta":271,"style":271},"# 1. Start minikube\nminikube start\n","Minikube",[273,454,455,460],{"__ignoreMap":271},[276,456,457],{"class":278,"line":279},[276,458,459],{"class":387},"# 1. Start minikube\n",[276,461,462,464],{"class":278,"line":317},[276,463,113],{"class":282},[276,465,466],{"class":286}," start\n",[232,468,469],{},"Confirm your cluster is ready:",[265,471,473],{"className":267,"code":472,"language":270,"meta":271,"style":271},"kubectl get nodes\n",[273,474,475],{"__ignoreMap":271},[276,476,477,479,482],{"class":278,"line":279},[276,478,365],{"class":282},[276,480,481],{"class":286}," get",[276,483,484],{"class":286}," nodes\n",[251,486],{},[254,488,490],{"id":489},"step-3-deploy-a-sample-workload-15-seconds","Step 3: Deploy a Sample Workload (15 Seconds)",[232,492,493],{},"Deploy an off-the-shelf Nginx service from Docker Hub into your cluster. No custom manifests or builds required:",[265,495,497],{"className":267,"code":496,"language":270,"meta":271,"style":271},"# Deploy sample Nginx workload\nkubectl create deployment hello-nginx --image=nginxdemos\u002Fhello --port=80\n\n# Expose as a ClusterIP service\nkubectl expose deployment hello-nginx --port=80 --target-port=80\n",[273,498,499,504,522,526,531],{"__ignoreMap":271},[276,500,501],{"class":278,"line":279},[276,502,503],{"class":387},"# Deploy sample Nginx workload\n",[276,505,506,508,510,513,516,519],{"class":278,"line":317},[276,507,365],{"class":282},[276,509,427],{"class":286},[276,511,512],{"class":286}," deployment",[276,514,515],{"class":286}," hello-nginx",[276,517,518],{"class":286}," --image=nginxdemos\u002Fhello",[276,520,521],{"class":286}," --port=80\n",[276,523,524],{"class":278,"line":406},[276,525,410],{"emptyLinePlaceholder":409},[276,527,528],{"class":278,"line":413},[276,529,530],{"class":387},"# Expose as a ClusterIP service\n",[276,532,533,535,538,540,542,545],{"class":278,"line":419},[276,534,365],{"class":282},[276,536,537],{"class":286}," expose",[276,539,512],{"class":286},[276,541,515],{"class":286},[276,543,544],{"class":286}," --port=80",[276,546,547],{"class":286}," --target-port=80\n",[232,549,550],{},"Verify that the sample pod is running:",[265,552,554],{"className":267,"code":553,"language":270,"meta":271,"style":271},"kubectl get pods -l app=hello-nginx\n",[273,555,556],{"__ignoreMap":271},[276,557,558,560,562,565,568],{"class":278,"line":279},[276,559,365],{"class":282},[276,561,481],{"class":286},[276,563,564],{"class":286}," pods",[276,566,567],{"class":286}," -l",[276,569,570],{"class":286}," app=hello-nginx\n",[251,572],{},[254,574,576],{"id":575},"step-4-connect-gefyra-15-seconds","Step 4: Connect Gefyra (15 Seconds)",[232,578,579],{},"Initialize Gefyra against your cluster:",[265,581,583],{"className":267,"code":582,"language":270,"meta":271,"style":271},"gefyra up\n",[273,584,585],{"__ignoreMap":271},[276,586,587,589],{"class":278,"line":279},[276,588,350],{"class":282},[276,590,591],{"class":286}," up\n",[232,593,594],{},"Gefyra automatically:",[596,597,598,610,617],"ul",{},[599,600,601,602,605,606,609],"li",{},"Deploys the lightweight ",[236,603,604],{},"Gefyra Operator"," and ",[236,607,608],{},"Stowaway"," gateway to the cluster.",[599,611,612,613,616],{},"Spins up the local ",[236,614,615],{},"Cargo"," WireGuard sidecar on your workstation.",[599,618,619],{},"Establishes an encrypted, bidirectional network tunnel.",[251,621],{},[254,623,625],{"id":624},"step-5-run-your-local-container-15-seconds","Step 5: Run Your Local Container (15 Seconds)",[232,627,628,629],{},"Create a sample HTML file on your machine and run an official Python container in Gefyra. ",[236,630,631],{},"Zero Dockerfile writing, zero image building:",[265,633,635],{"className":267,"code":634,"language":270,"meta":271,"style":271},"# 1. Create a local response file\nmkdir -p .\u002Fquickstart-app\necho \"\u003Ch1>⚡ Hello from Gefyra Local Bridge!\u003C\u002Fh1>\" > .\u002Fquickstart-app\u002Findex.html\n\n# 2. Run the local container in Gefyra\ngefyra run \\\n  -i python:3.12-alpine \\\n  -N local-hello \\\n  -v $(pwd)\u002Fquickstart-app:\u002Fapp \\\n  -c \"python3 -m http.server 8080 -d \u002Fapp\" \\\n  -d\n",[273,636,637,642,652,673,677,682,694,705,716,736,751],{"__ignoreMap":271},[276,638,639],{"class":278,"line":279},[276,640,641],{"class":387},"# 1. Create a local response file\n",[276,643,644,647,649],{"class":278,"line":317},[276,645,646],{"class":282},"mkdir",[276,648,440],{"class":286},[276,650,651],{"class":286}," .\u002Fquickstart-app\n",[276,653,654,658,661,664,667,670],{"class":278,"line":406},[276,655,657],{"class":656},"s2Zo4","echo",[276,659,660],{"class":293}," \"",[276,662,663],{"class":286},"\u003Ch1>⚡ Hello from Gefyra Local Bridge!\u003C\u002Fh1>",[276,665,666],{"class":293},"\"",[276,668,669],{"class":293}," >",[276,671,672],{"class":286}," .\u002Fquickstart-app\u002Findex.html\n",[276,674,675],{"class":278,"line":413},[276,676,410],{"emptyLinePlaceholder":409},[276,678,679],{"class":278,"line":419},[276,680,681],{"class":387},"# 2. Run the local container in Gefyra\n",[276,683,685,687,690],{"class":278,"line":684},6,[276,686,350],{"class":282},[276,688,689],{"class":286}," run",[276,691,693],{"class":692},"sTEyZ"," \\\n",[276,695,697,700,703],{"class":278,"line":696},7,[276,698,699],{"class":286},"  -i",[276,701,702],{"class":286}," python:3.12-alpine",[276,704,693],{"class":692},[276,706,708,711,714],{"class":278,"line":707},8,[276,709,710],{"class":286},"  -N",[276,712,713],{"class":286}," local-hello",[276,715,693],{"class":692},[276,717,719,722,725,728,731,734],{"class":278,"line":718},9,[276,720,721],{"class":286},"  -v",[276,723,724],{"class":293}," $(",[276,726,727],{"class":656},"pwd",[276,729,730],{"class":293},")",[276,732,733],{"class":286},"\u002Fquickstart-app:\u002Fapp",[276,735,693],{"class":692},[276,737,739,742,744,747,749],{"class":278,"line":738},10,[276,740,741],{"class":286},"  -c",[276,743,660],{"class":293},[276,745,746],{"class":286},"python3 -m http.server 8080 -d \u002Fapp",[276,748,666],{"class":293},[276,750,693],{"class":692},[276,752,754],{"class":278,"line":753},11,[276,755,756],{"class":286},"  -d\n",[232,758,759,760,763],{},"Your local container is now attached to the cluster network with direct access to all internal Kubernetes services and CoreDNS (",[273,761,762],{},".svc.cluster.local",").",[251,765],{},[254,767,769],{"id":768},"step-6-mount-bridge-the-workload-15-seconds","Step 6: Mount & Bridge the Workload (15 Seconds)",[232,771,772],{},"Gefyra 2.5+ decouples workload mounting from traffic routing:",[265,774,776],{"className":267,"code":775,"language":270,"meta":271,"style":271},"# 1. Mount the deployment with Carrier2 proxy\ngefyra mount create --target deployment\u002Fhello-nginx\u002Fhello-nginx --name hello-mount\n\n# 2. Bridge cluster traffic on port 80 to your local container on port 8080\ngefyra bridge create \\\n  --mount hello-mount \\\n  -p 80:8080 \\\n  -t local-hello \\\n  --match-path-prefix \u002F\n",[273,777,778,783,804,808,813,824,834,844,853],{"__ignoreMap":271},[276,779,780],{"class":278,"line":279},[276,781,782],{"class":387},"# 1. Mount the deployment with Carrier2 proxy\n",[276,784,785,787,790,792,795,798,801],{"class":278,"line":317},[276,786,350],{"class":282},[276,788,789],{"class":286}," mount",[276,791,427],{"class":286},[276,793,794],{"class":286}," --target",[276,796,797],{"class":286}," deployment\u002Fhello-nginx\u002Fhello-nginx",[276,799,800],{"class":286}," --name",[276,802,803],{"class":286}," hello-mount\n",[276,805,806],{"class":278,"line":406},[276,807,410],{"emptyLinePlaceholder":409},[276,809,810],{"class":278,"line":413},[276,811,812],{"class":387},"# 2. Bridge cluster traffic on port 80 to your local container on port 8080\n",[276,814,815,817,820,822],{"class":278,"line":419},[276,816,350],{"class":282},[276,818,819],{"class":286}," bridge",[276,821,427],{"class":286},[276,823,693],{"class":692},[276,825,826,829,832],{"class":278,"line":684},[276,827,828],{"class":286},"  --mount",[276,830,831],{"class":286}," hello-mount",[276,833,693],{"class":692},[276,835,836,839,842],{"class":278,"line":696},[276,837,838],{"class":286},"  -p",[276,840,841],{"class":286}," 80:8080",[276,843,693],{"class":692},[276,845,846,849,851],{"class":278,"line":707},[276,847,848],{"class":286},"  -t",[276,850,713],{"class":286},[276,852,693],{"class":692},[276,854,855,858],{"class":278,"line":718},[276,856,857],{"class":286},"  --match-path-prefix",[276,859,860],{"class":286}," \u002F\n",[251,862],{},[254,864,866],{"id":865},"step-7-verify-live-interception-hot-reloading","Step 7: Verify Live Interception & Hot-Reloading",[232,868,869],{},"Test that cluster traffic is intercepted and routed directly to your local file:",[265,871,873],{"className":267,"code":872,"language":270,"meta":271,"style":271},"kubectl run test-curl --rm -it --restart=Never --image=curlimages\u002Fcurl -- curl -s http:\u002F\u002Fhello-nginx\n",[273,874,875],{"__ignoreMap":271},[276,876,877,879,881,884,887,890,893,896,899,902,904],{"class":278,"line":279},[276,878,365],{"class":282},[276,880,689],{"class":286},[276,882,883],{"class":286}," test-curl",[276,885,886],{"class":286}," --rm",[276,888,889],{"class":286}," -it",[276,891,892],{"class":286}," --restart=Never",[276,894,895],{"class":286}," --image=curlimages\u002Fcurl",[276,897,898],{"class":286}," --",[276,900,901],{"class":286}," curl",[276,903,395],{"class":286},[276,905,906],{"class":286}," http:\u002F\u002Fhello-nginx\n",[232,908,909],{},[236,910,911],{},"Output:",[265,913,917],{"className":914,"code":915,"language":916,"meta":271,"style":271},"language-html shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Ch1>⚡ Hello from Gefyra Local Bridge!\u003C\u002Fh1>\n","html",[273,918,919],{"__ignoreMap":271},[276,920,921,924,928,931,934,937,939],{"class":278,"line":279},[276,922,923],{"class":293},"\u003C",[276,925,927],{"class":926},"swJcz","h1",[276,929,930],{"class":293},">",[276,932,933],{"class":692},"⚡ Hello from Gefyra Local Bridge!",[276,935,936],{"class":293},"\u003C\u002F",[276,938,927],{"class":926},[276,940,941],{"class":293},">\n",[943,944,946],"h3",{"id":945},"see-hot-reloading-in-action","See Hot-Reloading in Action",[232,948,949],{},"Edit your local file:",[265,951,953],{"className":267,"code":952,"language":270,"meta":271,"style":271},"echo \"\u003Ch1>🚀 Live Code Change Synced Instantly!\u003C\u002Fh1>\" > .\u002Fquickstart-app\u002Findex.html\n",[273,954,955],{"__ignoreMap":271},[276,956,957,959,961,964,966,968],{"class":278,"line":279},[276,958,657],{"class":656},[276,960,660],{"class":293},[276,962,963],{"class":286},"\u003Ch1>🚀 Live Code Change Synced Instantly!\u003C\u002Fh1>",[276,965,666],{"class":293},[276,967,669],{"class":293},[276,969,672],{"class":286},[232,971,972],{},"Run the curl verification command again:",[265,974,975],{"className":267,"code":872,"language":270,"meta":271,"style":271},[273,976,977],{"__ignoreMap":271},[276,978,979,981,983,985,987,989,991,993,995,997,999],{"class":278,"line":279},[276,980,365],{"class":282},[276,982,689],{"class":286},[276,984,883],{"class":286},[276,986,886],{"class":286},[276,988,889],{"class":286},[276,990,892],{"class":286},[276,992,895],{"class":286},[276,994,898],{"class":286},[276,996,901],{"class":286},[276,998,395],{"class":286},[276,1000,906],{"class":286},[232,1002,1003],{},[236,1004,911],{},[265,1006,1008],{"className":914,"code":1007,"language":916,"meta":271,"style":271},"\u003Ch1>🚀 Live Code Change Synced Instantly!\u003C\u002Fh1>\n",[273,1009,1010],{"__ignoreMap":271},[276,1011,1012,1014,1016,1018,1021,1023,1025],{"class":278,"line":279},[276,1013,923],{"class":293},[276,1015,927],{"class":926},[276,1017,930],{"class":293},[276,1019,1020],{"class":692},"🚀 Live Code Change Synced Instantly!",[276,1022,936],{"class":293},[276,1024,927],{"class":926},[276,1026,941],{"class":293},[232,1028,1029],{},"Your changes are live in the cluster immediately. No image builds, no container registry pushes, and no CI pipelines.",[251,1031],{},[254,1033,1035],{"id":1034},"step-8-clean-exit","Step 8: Clean Exit",[232,1037,1038],{},"When you are finished developing, restore the cluster and remove all local sidecars:",[265,1040,1042],{"className":267,"code":1041,"language":270,"meta":271,"style":271},"# 1. List and remove active bridges\ngefyra bridge list\ngefyra bridge delete \u003Cbridge-id>\n\n# 2. Unmount the workload and restore original pod image\ngefyra mount delete hello-mount\n\n# 3. Stop Gefyra components\ngefyra down\n",[273,1043,1044,1049,1058,1078,1082,1087,1097,1101,1106],{"__ignoreMap":271},[276,1045,1046],{"class":278,"line":279},[276,1047,1048],{"class":387},"# 1. List and remove active bridges\n",[276,1050,1051,1053,1055],{"class":278,"line":317},[276,1052,350],{"class":282},[276,1054,819],{"class":286},[276,1056,1057],{"class":286}," list\n",[276,1059,1060,1062,1064,1067,1070,1073,1076],{"class":278,"line":406},[276,1061,350],{"class":282},[276,1063,819],{"class":286},[276,1065,1066],{"class":286}," delete",[276,1068,1069],{"class":293}," \u003C",[276,1071,1072],{"class":286},"bridge-i",[276,1074,1075],{"class":692},"d",[276,1077,941],{"class":293},[276,1079,1080],{"class":278,"line":413},[276,1081,410],{"emptyLinePlaceholder":409},[276,1083,1084],{"class":278,"line":419},[276,1085,1086],{"class":387},"# 2. Unmount the workload and restore original pod image\n",[276,1088,1089,1091,1093,1095],{"class":278,"line":684},[276,1090,350],{"class":282},[276,1092,789],{"class":286},[276,1094,1066],{"class":286},[276,1096,803],{"class":286},[276,1098,1099],{"class":278,"line":696},[276,1100,410],{"emptyLinePlaceholder":409},[276,1102,1103],{"class":278,"line":707},[276,1104,1105],{"class":387},"# 3. Stop Gefyra components\n",[276,1107,1108,1110],{"class":278,"line":718},[276,1109,350],{"class":282},[276,1111,1112],{"class":286}," down\n",[232,1114,1115],{},[1116,1117,1118],"em",{},"(Optional) Tear down the local test cluster:",[265,1120,1122],{"className":267,"code":1121,"language":270,"meta":271,"style":271},"k3d cluster delete gefyra\n",[273,1123,1124],{"__ignoreMap":271},[276,1125,1126,1128,1130,1132],{"class":278,"line":279},[276,1127,105],{"class":282},[276,1129,424],{"class":286},[276,1131,1066],{"class":286},[276,1133,325],{"class":286},[251,1135],{},[254,1137,1139],{"id":1138},"next-steps","Next Steps",[1141,1142,1143,1148,1152],"card-group",{},[1144,1145,1147],"card",{"icon":34,"title":1146,"to":32},"Connect Your AI Coding Agent","Give Cursor, Claude Code, or Gemini CLI live cluster ground truth to test generated code without mocks.",[1144,1149,1151],{"icon":55,"title":1150,"to":53},"IDE Breakpoint Debugging","Set step-through breakpoints in VS Code or PyCharm triggered by live cluster traffic.",[1144,1153,1156],{"icon":1154,"title":1155,"to":48},"i-lucide-flame","Hot-Reloading Workflows","Configure instant hot-reloading for Django, FastAPI, Next.js, and Go Air.",[1158,1159,1160],"style",{},"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);}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 pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":271,"searchDepth":317,"depth":317,"links":1162},[1163,1164,1165,1166,1167,1168,1169,1172,1173],{"id":256,"depth":317,"text":257},{"id":358,"depth":317,"text":359},{"id":489,"depth":317,"text":490},{"id":575,"depth":317,"text":576},{"id":624,"depth":317,"text":625},{"id":768,"depth":317,"text":769},{"id":865,"depth":317,"text":866,"children":1170},[1171],{"id":945,"depth":406,"text":946},{"id":1034,"depth":317,"text":1035},{"id":1138,"depth":317,"text":1139},"Zero-dependency quickstart for Gefyra. Spin up a local cluster, connect Gefyra, and bridge a live Kubernetes service to your local code in 120 seconds.","md",null,{},{"title":5,"icon":10},{"title":227,"description":1174},"7b2c9ZINRihJjas02gVV0j67tYpnpgv_KGsHNFOadQ4",[1176,1182],{"title":12,"path":13,"stem":14,"description":1183,"icon":15,"children":-1},"Install the Gefyra CLI on macOS, Linux, or Windows via binary, Homebrew, or package managers — then connect to any Kubernetes cluster.",1795114692427]