Docker / OCI

mise-server implements the OCI Distribution Spec, proxying Docker image manifests and layers.

Endpoints

GET  /v2/                                          # API version check
GET  /v2/{name}/manifests/{reference}              # image manifest
GET  /v2/{name}/blobs/{digest}                     # layer/blob download
HEAD /v2/{name}/manifests/{reference}              # manifest existence
HEAD /v2/{name}/blobs/{digest}                     # blob existence
GET  /v2/{name}/tags/list                          # tag listing

Client Configuration

Use mise-server as a Docker registry mirror:

# Pull through mise-server
docker pull your-server:3000/library/nginx:latest

Or configure as a registry mirror in Docker daemon config (/etc/docker/daemon.json):

{
  "registry-mirrors": ["http://your-server:3000"]
}

Upstream Override

[settings.piers.docker]
upstream = "https://registry-1.docker.io"

export MISE_SERVER_DOCKER_UPSTREAM=https://registry-1.docker.io