Eternals NPM Registry

In Progress

Eternals NPM Registry is a private package management solution that lets teams host and distribute npm packages securely. It implements the full npm registry protocol, making it compatible with npm, yarn, and pnpm.

Tech Stack

Layer	Technology
API server	NestJS
Web UI	React
Database	PostgreSQL
Artifact storage	S3 / MinIO

Features

• Private and scoped packages — Host @your-org/package without going public
• Multi-package manager support — Works with npm, yarn, pnpm out of the box
• Authentication and access control — Role-based access to repositories
• Version management — Publish, deprecate, and yank specific versions
• Web UI — Browse and manage packages without the CLI
• Package analytics — Download counts and usage stats (planned)

Configuring Your Package Manager

npm

# Set registry for your scope
npm config set @your-org:registry https://registry.your-domain.com

# Or use a .npmrc file
echo "@your-org:registry=https://registry.your-domain.com" >> .npmrc

yarn

.yarnrc.yml

npmScopes:
  your-org:
    npmRegistryServer: "https://registry.your-domain.com"

pnpm

.npmrc

@your-org:registry=https://registry.your-domain.com

Publishing a Package

# Login to your private registry
npm login --registry=https://registry.your-domain.com

# Publish a scoped package
npm publish --registry=https://registry.your-domain.com

Note

All packages published to Eternals NPM Registry are private by default. Administrators can configure public access per-package or per-scope.

Architecture Overview

npm publish → Auth → Metadata (PostgreSQL) → Artifact (MinIO/S3)
npm install → Auth → Version resolve (PostgreSQL) → Tarball (MinIO/S3)

Self-Hosting with MinIO

For fully air-gapped environments, use MinIO as the S3-compatible storage backend:

services:
  npm-registry:
    image: eternals/npm-registry:latest
    environment:
      DATABASE_URL: postgresql://user:pass@db:5432/registry
      S3_ENDPOINT: http://minio:9000
      S3_BUCKET: npm-packages
      S3_ACCESS_KEY: minioadmin
      S3_SECRET_KEY: minioadmin

  minio:
    image: minio/minio
    command: server /data

Vision

Eternals NPM Registry aims to be a flexible, scalable alternative to GitHub Packages and JFrog Artifactory — giving teams complete ownership over their package distribution pipeline.