Charisma Mirrors — Fast package mirrors

How it works. Configure your tool once to use a Charisma mirror URL. We fetch from the upstream registry on first request, cache it on our side, and serve it back fast. Subsequent installs use the cached copy — no VPN, no upstream rate limits.

Container registries

Docker Hub proxy

Caches hub.docker.com. Use as a Docker daemon registry mirror or fully-qualified pulls.

docker-mirror.charisma.tech

Also reachable as ext-dockerhub.charisma.tech

Docker daemon mirror

{
  "registry-mirrors": [
    "https://docker-mirror.charisma.tech"
  ]
}

Save to /etc/docker/daemon.json, then sudo systemctl restart docker.

Explicit pull

docker pull docker-mirror.charisma.tech/library/nginx:1.27-alpine
docker pull docker-mirror.charisma.tech/getsentry/sentry:24.7.0
docker pull docker-mirror.charisma.tech/rocketchat/rocket.chat:latest

Official Docker Hub images need the library/ prefix (e.g. library/nginx, library/ubuntu).

containerd mirror (k8s)

server = "https://docker.io"

[host."https://docker-mirror.charisma.tech"]
  capabilities = ["pull", "resolve"]

Save to /etc/containerd/certs.d/docker.io/hosts.toml, then restart containerd.

GitHub Container Registry proxy

Caches ghcr.io for public images.

ghcr-mirror.charisma.tech

Also reachable as ext-github.charisma.tech

Explicit pull

docker pull ghcr-mirror.charisma.tech/owner/image:tag
docker pull ghcr-mirror.charisma.tech/grafana/grafana:11.2.0

containerd mirror

server = "https://ghcr.io"

[host."https://ghcr-mirror.charisma.tech"]
  capabilities = ["pull", "resolve"]

Save to /etc/containerd/certs.d/ghcr.io/hosts.toml.

Google Container Registry proxy

Caches gcr.io. Good for distroless and Google base images.

gcr-mirror.charisma.tech

Also reachable as ext-gcr.charisma.tech

Explicit pull

docker pull gcr-mirror.charisma.tech/distroless/static:nonroot
docker pull gcr-mirror.charisma.tech/distroless/base-debian12

containerd mirror

server = "https://gcr.io"

[host."https://gcr-mirror.charisma.tech"]
  capabilities = ["pull", "resolve"]

Kubernetes Registry proxy

Caches registry.k8s.io. Used for kube-apiserver, etcd, pause, etc.

k8s-mirror.charisma.tech

Also reachable as ext-k8s.charisma.tech

Explicit pull

docker pull k8s-mirror.charisma.tech/pause:3.9
docker pull k8s-mirror.charisma.tech/kube-apiserver:v1.30.0
docker pull k8s-mirror.charisma.tech/etcd:3.5.10-0

containerd mirror

server = "https://registry.k8s.io"

[host."https://k8s-mirror.charisma.tech"]
  capabilities = ["pull", "resolve"]

Application registries

npm proxy

Caches registry.npmjs.org.

https://npm-mirror.charisma.tech/

Also reachable as ext-npm.charisma.tech

.npmrc (project or user)

registry=https://npm-mirror.charisma.tech/

CLI one-shot

npm config set registry https://npm-mirror.charisma.tech/
npm install lodash

Yarn 1+2 proxy

Same backend as npm — Yarn speaks the npm protocol.

https://yarn-mirror.charisma.tech/

Also reachable as ext-yarn.charisma.tech

Yarn 1.x — .yarnrc

registry "https://yarn-mirror.charisma.tech/"

Yarn 2+/Berry — .yarnrc.yml

npmRegistryServer: "https://yarn-mirror.charisma.tech/"
unsafeHttpWhitelist:
  - yarn-mirror.charisma.tech

PyPI proxy

Caches pypi.org. Works with pip, poetry, pipenv, uv, hatch.

https://pypi-mirror.charisma.tech/simple/

Also reachable as ext-pypi.charisma.tech

pip — global

pip config set global.index-url https://pypi-mirror.charisma.tech/simple/
pip install requests

Poetry — pyproject.toml

[[tool.poetry.source]]
name = "charisma"
url = "https://pypi-mirror.charisma.tech/simple/"
priority = "primary"

uv / env var

export UV_INDEX_URL=https://pypi-mirror.charisma.tech/simple/
export PIP_INDEX_URL=https://pypi-mirror.charisma.tech/simple/

NuGet proxy

Caches api.nuget.org. v3 protocol.

https://nuget-mirror.charisma.tech/index.json

Also reachable as ext-nugget.charisma.tech

NuGet.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="charisma" value="https://nuget-mirror.charisma.tech/index.json"
         protocolVersion="3" />
  </packageSources>
</configuration>

dotnet CLI

dotnet nuget add source https://nuget-mirror.charisma.tech/index.json \
  --name charisma
dotnet restore

Helm path

Caches popular chart repos. Use the path-based URLs below.

https://helm-mirror.charisma.tech/helm-bitnami

Also reachable as ext-helm.charisma.tech

helm repo add

helm repo add charisma-bitnami https://helm-mirror.charisma.tech/helm-bitnami
helm repo update
helm search repo bitnami

Want a different upstream cached? Open an issue or contact ops.

Coming soon

Debian / Ubuntu APT prepped

apt mirror with raw caches for Debian + Ubuntu archives, including security.

apt-mirror.charisma.tech

Configured but not yet live — DNS pending.