kuik is a container image routing, mirroring (caching) and replication system for Kubernetes
See the code
[!WARNING] kuik v3 is in a very early stage of development: it is not stable nor feature complete yet. See Status for what works today. If you are looking for the latest stable version, it is maintained on the
2.3.xbranch: see its releases and its documentation on kuik.enix.io.
kuik (pronounced /kwɪk/, like "quick") is the shortname of kube-image-keeper.
✅ Its primary objective is to maximize the availability of Pod images strictly within the Kubernetes cluster it runs on.
✅ Its secondary goal is to ensure bulletproof reliability by keeping the manipulation of Kubernetes primitives to an absolute minimum.
It relies on three core mechanisms:
[!NOTE] Image routing is performed at Pod creation by a lightweight
MutatingWebhookthat automatically rewrites the image path whenever the source registry becomes unavailable.
This branch holds kuik v3, a rewrite currently in development and released as alphas. Two milestones lie ahead:
| Feature | Status |
|---|---|
Image routing (ImageAlternative, mutating webhook) | Available since 3.0.0-alpha.2 |
| Pull secret injection (secret syncer) | Available since 3.0.0-alpha.3 |
Image copy (ImageMirror) | Available since 3.0.0-alpha.4 |
Image monitoring (ImageMonitor) | Tracking and checks available since 3.0.0-alpha.4; drift and alternatives merged on main (#739, #745), shipping in the next alpha |
| Admission validation | Planned for the beta |
Credentials from a cloud provider (auth.provider) | Planned for v3.1 (#747) |
Plain-HTTP alternatives and mirror destinations (insecure) | Available since 3.0.0-alpha.2 for ImageAlternative, since 3.0.0-alpha.4 for ImageMirror |
| Private certificate authorities | Not planned yet (#750) |
| Migration from v2 | None: a migration plan will be proposed once GA is out (#749) |
docs/v3/, starting with spec.md. It is the source of truth for v3 behaviour, frozen for now, it may evolve after we reach beta.ImageAlternative (routing), ImageMirror (copy) and ImageMonitor (monitoring), described in the CRD reference.Development process and decisions are recorded in notes/. Contributions follow CONTRIBUTING.md.
kube-image-keeper is developed by Enix and released under the MIT License.
147 followers · starred Sep 2024
609 followers · starred Mar 2023
452 followers · starred Feb 2026
432 followers · starred Sep 2023
kuik is a container image routing, mirroring (caching) and replication system for Kubernetes
See the code
[!WARNING] kuik v3 is in a very early stage of development: it is not stable nor feature complete yet. See Status for what works today. If you are looking for the latest stable version, it is maintained on the
2.3.xbranch: see its releases and its documentation on kuik.enix.io.
kuik (pronounced /kwɪk/, like "quick") is the shortname of kube-image-keeper.
✅ Its primary objective is to maximize the availability of Pod images strictly within the Kubernetes cluster it runs on.
✅ Its secondary goal is to ensure bulletproof reliability by keeping the manipulation of Kubernetes primitives to an absolute minimum.
It relies on three core mechanisms:
[!NOTE] Image routing is performed at Pod creation by a lightweight
MutatingWebhookthat automatically rewrites the image path whenever the source registry becomes unavailable.
This branch holds kuik v3, a rewrite currently in development and released as alphas. Two milestones lie ahead:
| Feature | Status |
|---|---|
Image routing (ImageAlternative, mutating webhook) | Available since 3.0.0-alpha.2 |
| Pull secret injection (secret syncer) | Available since 3.0.0-alpha.3 |
Image copy (ImageMirror) | Available since 3.0.0-alpha.4 |
Image monitoring (ImageMonitor) | Tracking and checks available since 3.0.0-alpha.4; drift and alternatives merged on main (#739, #745), shipping in the next alpha |
| Admission validation | Planned for the beta |
Credentials from a cloud provider (auth.provider) | Planned for v3.1 (#747) |
Plain-HTTP alternatives and mirror destinations (insecure) | Available since 3.0.0-alpha.2 for ImageAlternative, since 3.0.0-alpha.4 for ImageMirror |
| Private certificate authorities | Not planned yet (#750) |
| Migration from v2 | None: a migration plan will be proposed once GA is out (#749) |
docs/v3/, starting with spec.md. It is the source of truth for v3 behaviour, frozen for now, it may evolve after we reach beta.ImageAlternative (routing), ImageMirror (copy) and ImageMonitor (monitoring), described in the CRD reference.Development process and decisions are recorded in notes/. Contributions follow CONTRIBUTING.md.
kube-image-keeper is developed by Enix and released under the MIT License.
147 followers · starred Sep 2024
609 followers · starred Mar 2023
452 followers · starred Feb 2026
432 followers · starred Sep 2023