cyrius44/portalcrane repository overview

⁠🐳 Portalcrane

Portalcrane is a self-hosted Docker Registry Manager.
It provides a modern, intuitive interface to browse, search, and manage images and tags, with a staging pipeline including vulnerability scanning.

⁠Features

• 🎨 Modern UI with light / dark / auto themes
• 🔐 Local authentication (admin + per-user accounts) with optional OIDC support
• 👥 Multi-user management with granular pull / push permissions
• 📁 Folder-based access control (per-user pull/push permissions on image namespaces)
• 📦 Browse, search, and paginate images and tags
• 🗑️ Delete images or individual tags
• 🏷️ Retag: add new tags to existing images
• 🚀 Staging pipeline: Search Docker Hub → Pull → Trivy CVE scan (optional) → Push to registry
• 📊 Dashboard with live stats (image count, disk usage, largest image, user & admin counts)
• 🔍 Advanced mode: detailed image metadata (layers, labels, env vars, architecture…)
• 🌐 External registries: CRUD management + connectivity test
• 🔄 Sync: push local images to external registries (full or per-image)
• 📋 Audit logs: full history of API operations
• 🔒 Registry proxy with authentication enforcement
• ℹ️ About panel with version check against the latest GitHub release
• 🐳 Single-container deployment (frontend + backend + registry in one image)

⁠Architecture

⁠Quick Start

⁠Docker CLI

docker run -d \
  --name portalcrane \
  -p 8080:8080 \
  -e ADMIN_USERNAME=admin \
  -e ADMIN_PASSWORD=yourpassword \
  -e SECRET_KEY=your-secret-key \
  -v portalcrane_data:/var/lib/portalcrane \
  cyrius44/portalcrane:latest

Open http://localhost:8080⁠ and log in with your admin credentials.

⁠License

MIT — see LICENSE⁠ for details.

Author: @cyr-ius⁠

Repository: https://github.com/cyr-ius/portalcrane⁠

⁠Screenshot