GoogleContainerTools /kaniko
Build Container Images In Kubernetes
★ 15,745⑂ 1,523👁 3⑃ 1,890● 1,596▤ 61
More from this author
+1
Daily
15,745
stars
1,523
forks
3
watchers
1,890
prs
1,596
issues
61
releases
README
🧊 This project is archived and no longer developed or maintained. 🧊
The code remains available for historic purposes.
The README as of the archival date remains unchanged below for historic purposes.
-----
kaniko - Build Images In Kubernetes
🚨NOTE: kaniko is not an officially supported Google product🚨
!kaniko logo
kaniko is a tool to build container images from a Dockerfile, inside a container
or Kubernetes cluster.
kaniko doesn't depend on a Docker daemon and executes each command within a
Dockerfile completely in userspace. This enables building container images in
environments that can't easily or securely run a Docker daemon, such as a
standard Kubernetes cluster.
kaniko is meant to be run as an image: gcr.io/kaniko-project/executor. We do
not recommend running the kaniko executor binary in another image, as it
might not work as you expect - see Known Issues.
We'd love to hear from you! Join us on
kaniko Kubernetes Slack
:mega: Please fill out our
quick 5-question survey so that we can
learn how satisfied you are with kaniko, and what improvements we should make.
Thank you! :dancers:
_If you are interested in contributing to kaniko, see
DEVELOPMENT.md and CONTRIBUTING.md._
Table of Contents _generated with
DocToc_
- kaniko - Build Images In Kubernetes
- 🚨NOTE: kaniko is not an officially supported Google product🚨
- Community
- How does kaniko work?
- Known Issues
- Demo
- Tutorial
- Using kaniko
- kaniko Build Contexts
- Using Azure Blob Storage
- Using Private Git Repository
- Using Standard Input
- Running kaniko
- Running kaniko in a Kubernetes cluster
- Kubernetes secret
- Running kaniko in gVisor
- Running kaniko in Google Cloud Build
- Running kaniko in Docker
- Caching
- Caching Layers
- Caching Base Images
- Pushing to Different Registries
- Pushing to Docker Hub
- Pushing to Google GCR
- Pushing to GCR using Workload Identity
- Pushing to Amazon ECR
- Pushing to Azure Container Registry
- Pushing to JFrog Container Registry or to JFrog Artifactory
- Additional Flags
- Flag --build-arg
- Flag --cache
- Flag --cache-dir
- Flag --cache-repo
- Flag --cache-copy-layers
- Flag --cache-run-layers
- Flag --cache-ttl duration
- Flag --cleanup
- Flag --compressed-caching
- Flag --context-sub-path
- Flag --custom-platform
- Flag --digest-file
- Flag --dockerfile
- Flag --force
- Flag --git
- Flag --image-name-with-digest-file
- Flag --image-name-tag-with-digest-file
- Flag --insecure
- Flag --insecure-pull
- Flag --insecure-registry
- Flag --label
- Flag --log-format
- Flag --log-timestamp
- Flag --no-push
- Flag --no-push-cache
- Flag --oci-layout-path
- Flag --push-retry
- Flag --registry-certificate
- Flag --registry-clientTop issues
#2105Security Policy violation Binary Artifacts434 comments · 2022-05-23#3408Security Policy violation Outside Collaborators79 comments · 2025-02-11#769error building image: error building stage: lstat /tmp/apt-key-gpghome.VoPBz66R2g/gnupg_spawn_agent_sentinel.lock: no such file or directory54 comments · 2019-09-15#1333Image build process Freezes on `Taking snapshot of full filesystem...`51 comments · 2020-06-29#1209Pushing images to dockerhub stopped working50 comments · 2020-04-23#909kaniko build using too many memory46 comments · 2019-12-11#687Kaniko supporting multiple auths46 comments · 2019-06-03#1297Can't use kaniko with alpine v3.12+ due to /var/run behavior42 comments · 2020-06-04
Discussions
#3397How does Kaniko interact with cloud providers?0 comments · 2025-01-29#3388How to define the special path when I pull code from git registry?0 comments · 2025-01-14#3377understanding --context and --dockerfile0 comments · 2024-12-24#3349Equivalent of Docker's `--secret`1 comments · 2024-10-24#3316Is Kaniko dead?1 comments · 2024-09-16#3306Cloudflair R2 storage0 comments · 2024-08-30#3272UNAUTHORIZED: authentication required0 comments · 2024-07-31#3185adding a squash option to kaniko build1 comments · 2024-05-31
Latest release
v1.24.0 v1.24.0 2025-05-23v1.24.0 Release 2025-05-21 The executor images in this release are: gcr.io/kaniko-project/executor:v1.24.0 gcr.io/kaniko-project/executor:latest The debug images are available at: gcr.io/kaniko-project/executor:debug gcr.io/kaniko-project/executor:v1.24.0-debug The slim executor images which don't contain any authentication binaries are available at: gcr.io/kaniko-project/executor:slim gcr.io/kaniko-project/executor:v1.24.0-slim Dependency Updates: chore(deps): bump google.golang.org/grpc from 1.64.0 to 1.64.1 by @dependabot in https://github.com/GoogleContainer