npm — DevOps Guide

Architecture

Verdaccio runs as a single container with OIDC authentication via Authelia.

• Image: Custom build from verdaccio/verdaccio:6 with verdaccio-openid-connect plugin
• Port: 4873 (internal)
• Storage: Bind mount at data/npm/storage/
• Config: npm/conf/config.yaml

Management

cd /opt/services/registries

# Start/stop
task up:npm
task down:npm

# Logs
task logs:npm

# Health check
curl -sf https://npm.registry.hochguertel.work/-/ping

Configuration

Edit npm/conf/config.yaml for:

• Package scopes and access rules
• Uplink (proxy) configuration
• Authentication settings
• Logging level

After changes, restart:

task down:npm && task up:npm

Backup

# Backup storage
tar -czf npm-backup-$(date +%Y%m%d).tar.gz data/npm/storage/