Habilitar el registro

El registro está habilitado por defecto en toda instalación de Pier. Solo necesitas:

1. Generar un token personal en el panel.
2. Escribir un .npmrc (o .yarnrc.yml para yarn berry) en tu proyecto.
3. Opcionalmente activar el proxy upstream si quieres que los paquetes públicos también se almacenen en caché.

1. Generar un token

1. Abre el panel de Pier y ve a Packages → Manage tokens.
2. Haz clic en New token y dale un nombre como laptop-2026.
3. Pier muestra el token en texto plano una sola vez — cópialo ahora. El formato es pier_npm_….

El token está vinculado a tu cuenta del panel. Revócalo desde la misma pantalla cuando quieras — todos los clientes existentes que usen ese token empiezan a recibir 401 de inmediato.

2. Configurar tu cliente

El .npmrc mínimo (funciona para npm, pnpm, bun y yarn classic con una línea extra):

registry=https://YOUR-PIER-HOST/registry/npm/
//YOUR-PIER-HOST/registry/npm/:_authToken=pier_npm_…
always-auth=true

always-auth=true es obligatorio para yarn 1.x (que de lo contrario omite el bearer en las peticiones GET) e inofensivo para npm/pnpm/bun.

Para yarn berry (2/3/4) el archivo de configuración es diferente — consulta Usar yarn 2/3/4 con Pier.

3. Verificar que funciona

curl https://YOUR-PIER-HOST/registry/npm/-/ping
# {}

Una respuesta {} correcta confirma que el registro es accesible. Luego:

npm whoami
# tester

Si recibes 401, vuelve a revisar el token y always-auth=true. Si recibes 503, Traefik aún no está activo — dale 30 segundos después de una ejecución reciente de bash install.sh.

4. (Opcional) habilitar el proxy upstream

Si quieres replicar npmjs.org a través de Pier para que el equipo use una sola URL:

1. Abre Packages → Upstream proxy.
2. Activa Enable upstream proxy.
3. Upstream URL tiene como valor por defecto https://registry.npmjs.org — déjalo así a menos que estés replicando una instancia interna de NPM Enterprise.
4. Packument TTL (seconds) — 600 (10 min) es un valor por defecto razonable; súbelo a 3600 si quieres menos idas y vueltas al upstream.
5. Max cache size (MiB) — 0 significa ilimitado (recomendado en hosts con abundante disco). Establece 2–5 GiB para equipos pequeños; 20+ GiB para réplicas de CI.
6. Haz clic en Save.

Toda la pestaña Mirror ahora lista cada paquete público que el equipo ha instalado a través de Pier. Marca con estrella los que te importan y filtra con Pinned only.

5. Elige tu guía de cliente

• Usar npm — npm 7 hasta 11.
• Usar yarn 1.x — la particularidad de always-auth.
• Usar yarn 2 / 3 / 4 — la configuración de .yarnrc.yml.
• Usar pnpm — consejo sobre workspaces.
• Usar bun — nota sobre el packument abreviado.

Siguiente: publicar o instalar

• ¿Quieres publicar un paquete privado? Ve a Publicar paquetes privados.
• ¿Quieres que CI instale a través de Pier? Consulta Integración con CI.
• ¿Te topaste con un muro? Solución de problemas cubre los casos comunes de 401/409/304.