Skip to content
This repository has been archived by the owner. It is now read-only.
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


freshpod helps you automatically restart containers on Kubernetes when their image is updated.

It is designed for single-instance Kubernetes clusters, such as Minikube or Docker for Windows/Mac.

freshpod detects you rebuilt an image and it deletes the Kubernetes Pods are running that image. This way, your workload controller (such as Deployment) will create new Pods running the new image.

🆕 Check out Skaffold, a new tool by Google that simplifies local Kubernetes development experience. Skaffold supersedes freshpod.


This demo shows refactoring an application and running docker build will automatically restart the application with the new image on Minikube:

A command line demo of freshpod replacing pods when the image is updated

Install on Minikube

freshpod is available as an add-on for Minikube. You just need to enable it:

minikube addons enable freshpod

Install on “Docker for Mac/Windows”

If you’re using Kubernertes on Docker for Mac/Windows, you can directly apply the manifest used by Minikube:

kubectl apply -f

Try it out!

Get some test images and tag the :1.0 image as hello:latest:

eval $(minikube docker-env) # not necessary for docker-for-mac/windows
docker pull
docker pull
docker tag hello:latest

Run a 2-replica Deployment and NodePort Service with hello:latest image:

kubectl run hello --image=hello --port 8080 --replicas=2 \

kubectl expose deploy/hello --type=NodePort

Visit the app (note the 1.0.0):

$ URL=$(minikube service hello --url)
$ curl "$URL"
Hello, world!
Version: 1.0.0
Hostname: hello-5766f88f9c-67lgz

Re-tag the hello:latest image with the 2.0 version:

docker tag hello

Visit the app again (note the version has changed to 2.0.0):

$ curl "$URL"
Hello, world!
Version: 2.0.0
Hostname: hello-5766f88f9c-h88df


See for more information.

This is not an official Google product.