Manage registries

Add a registry

spin registry add official https://github.com/example/spin-registry.git

The alias is the shorthand prefix used in spin search and spin add <alias>/<id>. Aliases must be safe directory names: no slashes, colons, whitespace, or leading dashes.

Local registries are symlinked (with a copy fallback):

spin registry add local ~/code/spin-registry

List registries

spin registry list

Shows alias, source, kind, template count, and cache path.

Update a registry

spin registry update official

Git registries are fetched and reset to origin/HEAD. Local registries are skipped. Omit the alias to update every git registry.

Remove a registry

spin registry remove official

This deletes the registry entry and its cache. If pinned templates depend on templates in this registry, the command refuses unless you pass --purge-pinned.

Force re-add

Replace an existing alias:

spin registry add official https://github.com/example/spin-registry.git --force