Démarrer rapidement un projet logiciel.

Verdaccio

Verdaccio — registre npm/yarn privé self-hosted sur VPS.

< 128 Mo RAM 1 vCPU Port 4873 En validation

En validation

L'installation automatique de cette solution est prête et passe actuellement nos tests sur serveur réel. La commande ouvrira dès que la validation sera terminée.

Stack technique

DockerNode.js
RAM minimum< 128 Mo
CPU minimum1 vCPU
Port par défaut4873
OS compatiblesDistributions Linux au choix

Hébergez votre propre registre npm/yarn/pnpm sur votre VPS : proxifiez npmjs.org, publiez vos packages privés et contrôlez les dépendances de vos projets JavaScript.

Fonctionnalités clés

Proxy de npmjs.org — mettez en cache les packages localement pour éviter les pannes de registre lors des builds CI.
Publication de packages privés — publiez et versionnez vos bibliothèques JavaScript internes sans les exposer au registre public.
Support multi-clients — fonctionne nativement avec npm, Yarn et pnpm sans aucune modification de la configuration cliente.
Déploiement en conteneur unique léger — moins de 128 Mo de RAM sur un VPS ServOrbit.
Contrôle d'accès par token — créez des comptes et des tokens API pour restreindre la lecture ou la publication par scope.
Mode hors ligne — sert les packages mis en cache sans connexion internet pour des builds reproductibles.

Quand utiliser cette solution ?

1

Registre privé pour votre équipe

Publiez vos bibliothèques JavaScript internes sous votre propre namespace. Chaque développeur les installe comme des packages publics — sans URL Git manuels ni copier-coller.

2

Cache fiable pour les pipelines CI

Proxifiez npmjs.org via Verdaccio et mettez en cache chaque package téléchargé. Si le registre public tombe pendant un build, Verdaccio sert la version en cache de manière transparente.

3

Environnements hors ligne

Préchauffez le cache avec une installation connectée, puis coupez l'accès internet. Verdaccio continue de servir tous les packages vus précédemment sans aucune connexion requise.

Déployer Verdaccio sur votre VPS

Guide optimisé pour les VPS Cloud ServOrbit.

01

Accéder au registre

Verdaccio ne nécessite pas de nom de domaine. Ouvrez un tunnel SSH : ssh -L 4873:127.0.0.1:<port> root@<ip-vps>, puis pointez npm vers le tunnel : npm set registry http://localhost:4873. Pour un accès permanent à toute l'équipe, rattachez un domaine depuis votre espace client ServOrbit.

02

Créer votre premier utilisateur

Exécutez npm adduser --registry http://localhost:4873. Saisissez un nom d'utilisateur, un mot de passe et un e-mail. Ce premier utilisateur devient l'administrateur du registre.

03

Publier un package privé

Dans le répertoire de votre package, exécutez npm publish --registry http://localhost:4873. Le package est stocké sur le VPS et disponible pour tout développeur ou système CI authentifié.

04

Configurer les règles de scope proxy (optionnel)

Éditez config.yaml dans le volume du conteneur pour router les scopes spécifiques (ex. @acme/*) vers votre registre privé et tous les autres vers npmjs.org. Redémarrez le conteneur pour appliquer : docker compose restart verdaccio.

Questions fréquentes

Non. Verdaccio proxifie npmjs.org par défaut — les demandes de packages absents du registre local sont transmises au registre public, mises en cache puis servies. Vous pouvez continuer à utiliser tous les packages publics normalement.

Démarrer rapidement un projet logiciel.

Verdaccio n'est pas encore commandable.

L'installation automatique de cette solution est prête et passe actuellement nos tests sur serveur réel. La commande ouvrira dès que la validation sera terminée.

Besoin d'aide ?

Parcourez notre centre d'aide et notre FAQ, ou contactez notre équipe — rappel, WhatsApp ou e-mail. Support en français, anglais et arabe.

Écrire sur WhatsApps'ouvre dans un nouvel onglet