Back to Skills

local-registry

Start and manage a local OCI registry for Bottlerocket kit development

4stars11forksUpdated 3/1/2026

Security Assessment

Medium Risk(50/100)

Detected risks:

Sensitive File Access([SKILL.md] .env)
Privilege Escalation([SKILL.md] sudo)
Security Score50/100

About local-registry

The 'local-registry' skill is designed to facilitate the setup and management of a local OCI (Open Container Initiative) registry for Bottlerocket kit development. It provides an easy way to create a self-contained local registry, enabling users to build and test kits without needing external registry access. This local registry is particularly useful in isolated environments or when developing in a network with limited connectivity. By managing a local registry, users can streamline the development process and improve efficiency when working with Bottlerocket kits.

FAQ

How do I start the local registry?

Use the command 'brdev registry start' to start the local OCI registry. This will launch the registry on 'localhost:5000' with persistence enabled.

Can I use a custom port for the registry?

Yes, you can configure a custom port by setting the 'FORESTER_REGISTRY_PORT' environment variable.

What happens if the Docker daemon is not running?

If the Docker daemon is not running, you'll receive an error. You can resolve this by starting Docker with the command 'sudo systemctl start docker'.

Do I need Docker installed?

Yes, Docker must be installed and running on your system for the local-registry skill to work.

How do I stop the local registry?

To stop the local registry, use the command 'brdev registry stop'. This will stop the registry while preserving the registry data volume.

Install local-registry

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill