Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
pluginagentmarketplace avatar

Docker Registry

  • 26 installs
  • 2 repo stars
  • Updated January 5, 2026
  • pluginagentmarketplace/custom-plugin-docker

Stand up a private Docker Registry v2 with a web UI for tagging, browsing, and deleting images on a developer’s LAN or VPS.

About

Docker Registry is a template skill that packages a ready-to-run private image registry for indie teams tired of pushing every build to a public hub. It wires the official Registry 2 daemon with Joxit’s UI so you can catalog tags, show digests, and delete images from a browser while keeping data on a local volume. Solo builders use it when self-hosting APIs, agents, or multi-service SaaS and need a cheap internal mirror for CI or staging deploys. The compose file documents ports, CORS headers, delete enablement, and UI catalog limits so an agent can adapt auth and TLS without rediscovering registry quirks. You still must harden REGISTRY_SECURED, authentication, and backups for production; this skill accelerates the first correct compose layout on your machine or edge server.

  • Docker Compose 3.8 stack: registry:2 on port 5000 plus joxit/docker-registry-ui on port 8080
  • Filesystem-backed storage with named volume registry-data and optional ./auth mount
  • UI env flags for catalog tags, delete images, content digest display, and proxy to internal registry URL
  • Bridge network registry-net isolating registry and UI services
  • Inline usage steps: compose up -d, tag images, push to localhost:5000

Docker Registry by the numbers

  • 26 all-time installs (skills.sh)
  • Ranked #884 of 1,453 DevOps & CI/CD skills by installs in the Skillselion catalog
  • Security screen: HIGH risk (skills.sh audit)
  • Data as of Jul 26, 2026 (Skillselion catalog sync)
npx skills add https://github.com/pluginagentmarketplace/custom-plugin-docker --skill docker-registry

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs26
repo stars2
Security audit1 / 3 scanners passed
Last updatedJanuary 5, 2026
Repositorypluginagentmarketplace/custom-plugin-docker

What it does

Stand up a private Docker Registry v2 with a web UI for tagging, browsing, and deleting images on a developer’s LAN or VPS.

Files

SKILL.mdMarkdownGitHub ↗

Docker Registry Skill

Set up and manage private Docker registries for secure image distribution and management.

Purpose

Deploy private registries, configure authentication, and manage images across multiple registries.

Parameters

ParameterTypeRequiredDefaultDescription
registry_typeenumNodockerdocker/ecr/gcr/acr
authbooleanNotrueEnable authentication
tlsbooleanNotrueEnable TLS

Registry Types

RegistryProviderAuth Method
Docker HubDockerUsername/token
GHCRGitHubGitHub token
ECRAWSIAM/CLI
GCRGoogleService account
ACRAzureService principal

Private Registry Setup

Docker Compose

services:
  registry:
    image: registry:2
    ports:
      - "5000:5000"
    volumes:
      - registry_data:/var/lib/registry
      - ./auth:/auth
      - ./certs:/certs
    environment:
      REGISTRY_AUTH: htpasswd
      REGISTRY_AUTH_HTPASSWD_REALM: Registry Realm
      REGISTRY_AUTH_HTPASSWD_PATH: /auth/htpasswd
      REGISTRY_HTTP_TLS_CERTIFICATE: /certs/domain.crt
      REGISTRY_HTTP_TLS_KEY: /certs/domain.key
    restart: unless-stopped

volumes:
  registry_data:

Create Auth File

# Create htpasswd file
docker run --rm --entrypoint htpasswd \
  httpd:alpine -Bbn admin password > auth/htpasswd

Registry Operations

Login

# Docker Hub
docker login

# GitHub Container Registry
echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME --password-stdin

# AWS ECR
aws ecr get-login-password | docker login --username AWS --password-stdin <account>.dkr.ecr.<region>.amazonaws.com

# Private registry
docker login registry.example.com

Push/Pull

# Tag for registry
docker tag myapp:latest registry.example.com/myapp:latest

# Push
docker push registry.example.com/myapp:latest

# Pull
docker pull registry.example.com/myapp:latest

Image Management

# List images in registry (API)
curl -X GET https://registry.example.com/v2/_catalog

# List tags
curl -X GET https://registry.example.com/v2/myapp/tags/list

# Delete image (via API)
curl -X DELETE https://registry.example.com/v2/myapp/manifests/<digest>

Multi-Registry Sync

# Copy between registries
skopeo copy \
  docker://source-registry/image:tag \
  docker://dest-registry/image:tag

# Sync all tags
skopeo sync --src docker --dest docker \
  source-registry/image dest-registry/

Cloud Registry Setup

AWS ECR

# Create repository
aws ecr create-repository --repository-name myapp

# Login
aws ecr get-login-password --region us-east-1 | \
  docker login --username AWS --password-stdin <account>.dkr.ecr.us-east-1.amazonaws.com

# Push
docker push <account>.dkr.ecr.us-east-1.amazonaws.com/myapp:latest

Google GCR

# Auth with service account
gcloud auth configure-docker

# Push
docker push gcr.io/project-id/myapp:latest

Error Handling

Common Errors

ErrorCauseSolution
unauthorizedBad credentialsRe-login
manifest unknownImage not foundCheck name/tag
denied: accessNo permissionCheck IAM/roles
TLS handshakeCertificate issueAdd to trusted certs

Fallback Strategy

1. Verify credentials: docker login 2. Check image exists in registry 3. Verify network connectivity

Troubleshooting

Debug Checklist

  • [ ] Logged in? docker login
  • [ ] Image tagged correctly?
  • [ ] Registry accessible? curl https://registry/v2/
  • [ ] TLS configured? Check certificates

Usage

Skill("docker-registry")

Assets

  • assets/docker-compose-registry.yaml - Registry setup
  • scripts/registry-setup.sh - Setup script

Related Skills

  • docker-optimization
  • docker-ci-cd

Related skills

FAQ

Is Docker Registry safe to install?

skills.sh reports 1 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

DevOps & CI/CDdeployinfra

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.