npm Registry (Verdaccio)

Private npm package registry powered by Verdaccio.

URL: npm.registry.hochguertel.work

Architecture

graph LR
    client["npm / pnpm / yarn"]
    verdaccio["Verdaccio\n(port 4873)"]
    npmjs["npmjs.org\n(upstream proxy)"]
    authelia["Authelia\n(OIDC)"]
    traefik["Traefik"]

    client --> traefik --> verdaccio
    verdaccio -->|"public packages"| npmjs
    verdaccio -->|"auth"| authelia

Features

• Private npm packages with scoped publishing
• Proxies to npmjs.org for public packages
• Authelia OIDC single sign-on
• Web UI for browsing packages
• Group-based access control (developers can publish)

Quick Start

npm set registry https://npm.registry.hochguertel.work
npm login --registry https://npm.registry.hochguertel.work
npm publish

Package Scopes

Scope	Access	Publish	Proxy
@copilot-webui/*	Authenticated	developers	No (local only)
@histoire/*	All	developers	Yes (npmjs fallback)
@*/*	All	developers	Yes
**	All	developers	Yes

Configuration

Setting	Value
Registry URL	https://npm.registry.hochguertel.work
Auth	Authelia OIDC
Storage	data/npm/storage/
Config	npm/conf/config.yaml

Related Guides

• Developer Guide — publishing, installing, CI/CD
• DevOps Guide — architecture, management, backup