Skip to content

Custom Registries

mise-server can proxy any HTTP-based package source as a custom registry.

Configuration

Define custom registries in mise-server.toml:

toml
[[custom_registries]]
name = "internal-tools"
upstream = "https://packages.internal.example.com"

Endpoints

GET /custom/{name}/{path}    # proxied request

Client Usage

bash
curl http://your-server:3000/custom/internal-tools/some-package-1.0.tar.gz

Custom registries follow the same caching behavior as built-in registries: cache miss triggers an upstream fetch, the response is stored as a BLAKE3-hashed blob, and subsequent requests are served from cache.

Licensed under FSL-1.1-ALv2. Maintained by @jdx.