spegel-org/spegel

Stateless cluster local OCI registry mirror.

Go

3,810

2,239 commits

updated Oct 6, 2026

See the code

README

Spegel

spegel logo

Spegel, mirror in Swedish, is a stateless cluster local OCI registry mirror.

Note: Spegel is a project with an evolving API and no guaranteed support. Assistance is provided on a best-effort basis by the developers. We focus on the home lab and individual contributor use case.


Features

Spegel is for you if you are looking to do any of the following.

  • Locally cache images from external registries with no explicit configuration.
  • Avoid cluster failure during external registry downtime.
  • Improve image pull speed and pod startup time by pulling images from the local cache first.
  • Avoid rate-limiting when pulling images from external registries (e.g. Docker Hub).
  • Decrease egressing traffic outside of the clusters network.
  • Increase image pull efficiency in edge node deployments.

Getting Started

Read the getting started guide to deploy Spegel.

Acknowledgements

Spegel was initially developed at Xenit AB.

cloud
containerd
docker
go
golang
kubernetes
oci
p2p
registry

spegel-org/spegel

Stateless cluster local OCI registry mirror.

Go

3,810

2,239 commits

updated Oct 6, 2026

See the code

README

Spegel

spegel logo

Spegel, mirror in Swedish, is a stateless cluster local OCI registry mirror.

Note: Spegel is a project with an evolving API and no guaranteed support. Assistance is provided on a best-effort basis by the developers. We focus on the home lab and individual contributor use case.


Features

Spegel is for you if you are looking to do any of the following.

  • Locally cache images from external registries with no explicit configuration.
  • Avoid cluster failure during external registry downtime.
  • Improve image pull speed and pod startup time by pulling images from the local cache first.
  • Avoid rate-limiting when pulling images from external registries (e.g. Docker Hub).
  • Decrease egressing traffic outside of the clusters network.
  • Increase image pull efficiency in edge node deployments.

Getting Started

Read the getting started guide to deploy Spegel.

Acknowledgements

Spegel was initially developed at Xenit AB.

cloud
containerd
docker
go
golang
kubernetes
oci
p2p
registry

Project health

Latest release

v0.7.4 · Jul 15, 2026

Releases this year

8

Significant stargazers

(top 24 of 113)

Yuan Tang

3,910 followers · starred Jun 2024

Yuki Okushi

1,519 followers · starred Jan 2024

Jan-Otto Kröpke

740 followers · starred Mar 2023

Juan Calderon-Perez

208 followers · starred Feb 2025