From bfcdf260a9753d303003b2d8d1fb59cff7c68251 Mon Sep 17 00:00:00 2001
From: elasticdotventures <brianh@elastic.ventures>
Date: Tue, 5 Aug 2025 04:45:57 +0000
Subject: [PATCH] Update podman-env documentation with local development
 example

Add practical example showing how to build images directly in minikube
and deploy them to Kubernetes without needing a separate registry.
This demonstrates the key value proposition of the Docker API
compatibility approach.
---
 site/content/en/docs/commands/podman-env.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/site/content/en/docs/commands/podman-env.md b/site/content/en/docs/commands/podman-env.md
index 1739c7647c..d205066f3c 100644
--- a/site/content/en/docs/commands/podman-env.md
+++ b/site/content/en/docs/commands/podman-env.md
@@ -42,6 +42,21 @@ docker run myapp
 
 This approach provides Docker API compatibility while using Podman as the container runtime inside minikube.
 
+### Building Images for Local Development
+
+You can build images directly in minikube and deploy them without a separate registry:
+
+```shell
+# Configure environment
+eval $(minikube podman-env)
+
+# Build image directly in minikube
+docker build -t my-local-app .
+
+# Deploy to Kubernetes without registry
+kubectl run my-app --image=my-local-app --image-pull-policy=Never
+```
+
 ### Options
 
 ```