A Mise backend plugin for installing tools from OCI registries.

Warning This plugin is under active development and is considered unstable. APIs, configuration options, and behavior may change without notice. Use at your own risk.

Requires Mise v2025.1.0+ and oras.

mise plugin install oci https://github.com/jbadeau/mise-oci.git

Set your registry and repository:

export MISE_OCI_REGISTRY="docker.io"
export MISE_OCI_REPOSITORY="jbadeau"

For private registries, also set credentials or use oras login:

export MISE_OCI_USERNAME="user"
export MISE_OCI_PASSWORD="pass"

# Install and run
mise install oci:azul-zulu@17.60.17
mise exec oci:azul-zulu@17.60.17 -- java --version

# List versions
mise ls-remote oci:azul-zulu

In .mise.toml:

[tools]
"oci:azul-zulu" = "17.60.17"

See example/README.md for publishing tools and SPECIFICATION.md for the MTA specification.

mise plugin link oci $PWD --force
mise install oci:azul-zulu@17.60.17