Hoe npm te installeren en te gebruiken op Ubuntu: Een complete beginnersgids (2025)

1. Introductie

Waarom npm gebruiken op Ubuntu?

Een van de essentiële tools voor zowel frontend‑ als backend‑ontwikkeling is npm (Node Package Manager). Veelgebruikt als de standaard package‑manager voor Node.js, maakt npm het eenvoudig om JavaScript‑bibliotheken en -tools te installeren en te beheren.

npm gebruiken op Ubuntu profiteert van de snelheid en flexibele pakketbeheer van Linux, waardoor de ontwikkelings‑efficiëntie aanzienlijk verbetert. Ubuntu is een populaire distributie onder ontwikkelaars en wordt gebruikt voor alles, van server‑operaties tot lokale ontwikkelomgevingen.

Bij het werken met Node.js‑gebaseerde frameworks zoals Vue.js, React of Next.js is het gebruikelijk om npm te gebruiken voor package‑beheer. Deze tools op Ubuntu installeren biedt een stabielere ontwikkelomgeving met minder problemen dan onder Windows of macOS.

Doel van dit artikel

Dit artikel leidt je door de installatie van npm op Ubuntu en het beheersen van de basisfunctionaliteit. Het is vooral nuttig voor de volgende lezers:

• Ontwikkelaars die nieuw zijn met Ubuntu
• Iedereen die moeite heeft met het opzetten van Node.js en npm
• Degenen die npm op een gestructureerde manier willen leren gebruiken

We behandelen meerdere installatiemethoden en bespreken de voor‑ en nadelen van elke methode. Daarnaast gaan we in op veelvoorkomende fouten, tips voor probleemoplossing en een verzameling handige commando’s om npm op Ubuntu soepel aan de praat te krijgen.

2. Hoe Node.js en npm te installeren op Ubuntu

Om npm op Ubuntu te gebruiken, moet je eerst Node.js installeren. Dit komt omdat npm wordt meegeleverd met Node.js; door Node.js te installeren, wordt npm automatisch beschikbaar.

In dit gedeelte behandelen we drie hoofdmethoden om Node.js en npm op Ubuntu te installeren. Elke methode heeft zijn eigen kenmerken, dus het is belangrijk een methode te kiezen die past bij jouw ontwikkelstijl en doelen.

Methode 1: Ubuntu‑officiële repository gebruiken

Stappen

Node.js is beschikbaar in de standaard repositories van Ubuntu. Deze methode is de eenvoudigste en meest beginnersvriendelijke.

sudo apt update
sudo apt install nodejs npm

Na de installatie kun je de geïnstalleerde versies controleren met de volgende commando’s:

node -v
npm -v

Voordelen

• Eenvoudige commando’s, makkelijk te volgen
• Veilige en stabiele versie geleverd

Nadelen

• De versie van Node.js/npm kan verouderd zijn, waardoor sommige nieuwere functies niet beschikbaar zijn

Methode 2: De NodeSource‑PPA gebruiken

Je kunt nieuwere versies van Node.js en npm krijgen via de NodeSource‑repository, die nauw aansluit bij de officiële Node.js‑ondersteuning.

Stappen (Voorbeeld: Node.js 18.x installeren)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

npm wordt automatisch geïnstalleerd samen met Node.js.

Voordelen

• Toegang tot nieuwere, maar stabiele versies
• Eenvoudig te installeren en werkt goed met Ubuntu

Nadelen

• Zoals bij elke PPA, kan het nodig zijn om systeem‑afhankelijkheden handmatig te beheren

Methode 3: nvm (Node Version Manager) gebruiken

Als je wilt schakelen tussen meerdere Node.js‑versies, is nvm de meest flexibele en handige methode.

Stappen

Eerst nvm installeren:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Vervolgens je shell herladen en Node.js installeren via nvm:

source ~/.bashrc  # or ~/.zshrc
nvm install 18
nvm use 18

npm wordt ook automatisch geïnstalleerd samen met Node.js.

Voordelen

• Gemakkelijk schakelen tussen verschillende Node.js‑versies
• Versie per project instellen voor betere compatibiliteit
• Heeft geen invloed op de systeem‑brede omgeving, veilig in gebruik

Nadelen

• Iets complexer op te zetten dan de andere methoden
• Je moet je shell‑configuratiebestand aanpassen

Welke methode moet je kiezen?

Als je npm op Ubuntu voor de lange termijn wilt gebruiken, is nvm de meest aanbevolen methode. Als je echter snel wilt beginnen, is de NodeSource‑PPA ook een solide keuze.

3. Basisgebruik van npm

Zodra je Node.js en npm op Ubuntu hebt geïnstalleerd, is de volgende stap om te beginnen met het beheren van pakketten met npm. npm is een krachtig hulpmiddel dat wordt gebruikt om JavaScript-pakketten te installeren, bij te werken en te verwijderen.

In dit gedeelte introduceren we de meest gebruikte npm-opdrachten om je op weg te helpen.

Pakketten installeren

Lokale installatie

Pakketten die alleen binnen een specifiek project worden gebruikt, moeten lokaal worden geïnstalleerd. Dit is de standaardbenadering en installeert het pakket in de node_modules-map, met details geregistreerd in package.json.

npm install package-name

Voorbeeld: Om axios te installeren

npm install axios

Slechts scripts binnen hetzelfde project kunnen dit pakket gebruiken.

Globale installatie

Gereedschappen die systeembreed worden gebruikt, zoals CLI-apps, moeten globaal worden geïnstalleerd.

npm install -g package-name

Voorbeeld: Om http-server globaal te installeren

sudo npm install -g http-server

Op Ubuntu moet je mogelijk sudo gebruiken bij het gebruik van de -g-optie.

Pakketten verwijderen

Als een pakket niet langer nodig is, kun je het verwijderen met de volgende opdrachten.

Een lokaal pakket verwijderen

npm uninstall package-name

Een globaal pakket verwijderen

sudo npm uninstall -g package-name

Pakketten bijwerken

Om pakketten bij te werken naar de nieuwste versie, kun je deze opdrachten gebruiken.

Een specifiek pakket bijwerken

npm update package-name

Alle afhankelijkheden tegelijk bijwerken

npm update

Let op dat dit pakketten alleen bijwerkt binnen het versiebereik dat is gespecificeerd in package.json, dus controleer altijd de versienummers.

Ontwikkelingspakketten installeren (–save-dev)

Pakketten die alleen in ontwikkelomgevingen worden gebruikt—zoals test- of build-tools—moeten worden geïnstalleerd met de --save-dev-optie.

npm install --save-dev package-name

Voorbeeld: Installeer jest als ontwikkelingsafhankelijkheid

npm install --save-dev jest

Dit voegt het pakket toe aan de devDependencies-sectie van je package.json.

Geïnstalleerde pakketten bekijken

Lokale pakketten weergeven

npm list

Globale pakketten weergeven

npm list -g --depth=0

Door --depth=0 te specificeren, worden alleen top-level pakketten weergegeven, wat de lijst gemakkelijker leesbaar maakt.

Projectafhankelijkheden beheren met package.json

Het package.json-bestand, gelegen in de hoofdmap van je project, speelt een sleutelrol in npm-workflows. Het slaat pakketnamen, versies en aangepaste scripts op en dient als configuratiebestand van het project.

Je kunt een package.json-bestand maken met de volgende opdracht:

npm init

Dit voert een interactieve setup uit. Als je de prompts wilt overslaan en standaardwaarden wilt gebruiken:

npm init -y

Dit genereert automatisch een package.json-bestand met standaardinstellingen.

4. Veelvoorkomende problemen en hoe ze op te lossen

Bij het gebruik van npm op Ubuntu kun je af en toe fouten of onverwacht gedrag tegenkomen. Dit gedeelte behandelt enkele van de meest voorkomende problemen—vooral die beginners vaak tegenkomen—en hoe ze op te lossen.

Machtigingsfouten

Symptomen

EACCES: permission denied

Deze fout verschijnt vaak bij het proberen van een globale npm-installatie.

Oorzaak

Dit gebeurt wanneer de huidige gebruiker geen schrijftoegang heeft tot de map waarin npm probeert pakketten te installeren. Op Ubuntu vereisen systeemmappen zoals /usr/lib/node_modules om veiligheidsredenen sudo om te wijzigen.

Oplossingen

• Voer de installatieopdracht uit met sudo :

  sudo npm install -g package-name
  

• Of wijzig de globale installatiemap naar je gebruikersmap om het gebruik van sudo te vermijden :

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  

Vervolgens voeg je het volgende toe aan je ~/.bashrc of ~/.profile om je PATH bij te werken:

export PATH="$HOME/.npm-global/bin:$PATH"

Om de wijzigingen toe te passen, herstart je terminal of voer je uit:

source ~/.bashrc

npm-commando niet gevonden

Symptomen

command not found: npm

Zelfs na installatie kan de terminal het npm-commando niet herkennen.

Oorzaken

• Node.js en npm zijn niet correct geïnstalleerd
• De locatie van de binary staat niet in je PATH

Oplossingen

Controleer eerst of de npm-binary beschikbaar is:

which npm

Als er niets wordt geretourneerd, installeer npm opnieuw of controleer of je omgevingsvariabelen correct zijn ingesteld. Als je nvm gebruikt, zorg er dan voor dat je shell‑configuratiebestand (bijv. .bashrc of .zshrc) de nvm‑initialisatiecode bevat:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Pakket wordt niet geïnstalleerd / Versieconflict

Symptomen

• Het installeren van een pakket leidt tot versieconflictfouten
• npm install veroorzaakt een stortvloed aan waarschuwingen

Oorzaak

npm geeft fouten of waarschuwingen weer wanneer pakketafhankelijkheden conflicteren. Dit gebeurt vaak in oudere projecten waar verouderde pakketten nog steeds vermeld staan.

Oplossingen

• Probeer de nieuwste versie te installeren:

  npm install package-name@latest
  

• Controleer de afhankelijkheidsboom van het pakket:

  npm ls package-name
  

• Forceer installatie (niet aanbevolen tenzij noodzakelijk):

  npm install --legacy-peer-deps
  

• Maak je project schoon en installeer afhankelijkheden opnieuw:

  rm -rf node_modules package-lock.json
  npm install
  

Andere handige debugtips

• npm doctor : Controleert je systeemconfiguratie en omgeving

  npm doctor
  

• npm audit : Scant op beveiligingsproblemen en stelt oplossingen voor

  npm audit
  npm audit fix
  

De meeste npm-fouten op Ubuntu worden in het Engels weergegeven, wat in het begin overweldigend kan aanvoelen. Maar door de meldingen zorgvuldig te lezen en stap voor stap te reageren, kun je het probleem meestal snel oplossen.

5. Veelgestelde vragen (FAQ)

Deze sectie beantwoordt veelvoorkomende vragen die nieuwe Ubuntu + npm‑gebruikers vaak hebben. Gebruik het om problemen te voorkomen voordat ze zich voordoen en om een soepelere ontwikkelomgeving op te bouwen.

Q1. Hoe kan ik npm bijwerken naar de nieuwste versie op Ubuntu?

A1.

Je kunt npm bijwerken naar de nieuwste versie met het volgende commando:

sudo npm install -g npm@latest

Als je nvm gebruikt, heb je geen sudo nodig:

npm install -g npm@latest

Om de geïnstalleerde versie te verifiëren:

npm -v

Q2. Wat is het verschil tussen globale en lokale npm‑installaties?

A2.

• Lokale installatie:
• Wordt gebruikt om afhankelijkheden binnen een specifiek project te beheren
• Pakketten worden geïnstalleerd in de node_modules‑directory
• Makkelijk deelbaar met teamgenoten via package.json
• Globale installatie:
• Wordt gebruikt voor tools die je systeemwijd toegankelijk wilt hebben (bijv. CLI‑tools)
• Pakketten worden meestal geïnstalleerd in /usr/lib/node_modules op Ubuntu
• sudo kan nodig zijn voor installatie

Q3. Wat zijn de voordelen van het gebruik van nvm?

A3.

nvm (Node Version Manager) laat je gemakkelijk schakelen tussen meerdere Node.js‑versies. Hier zijn de voordelen:

• Ideaal voor het beheren van verschillende versies voor verschillende projecten
• Heeft geen invloed op systeeminstellingen, waardoor het veiliger is
• npm wordt ook per Node‑versie beheerd, wat flexibele omgevingsinstellingen biedt

Q4. Wat moet ik doen als npm‑afhankelijkheden in de war raken?

A4.

Eerst, probeer node_modules en package-lock.json te verwijderen en vervolgens alles opnieuw te installeren:

rm -rf node_modules package-lock.json
npm install

Als dat niet helpt, probeer dan het npm ci‑commando voor een schone herinstallatie (aanbevolen voor CI/CD‑pijplijnen).

Q5. Is het oké als ik “WARN” of “audit” zie in de npm‑uitvoer?

A5.

Waarschuwingen (WARN) zijn niet fataal, maar ze geven wel potentiële problemen aan, zoals verouderde afhankelijkheden of verouderde functies.

Voor beveiligingsgerelateerde waarschuwingen kun je proberen ze automatisch te verhelpen met:

npm audit fix

Controleer idealiter de wijzigingen en commit ze met Git om een veilige en stabiele codebasis te behouden.

Q6. Welke soorten projecten kan ik bouwen met npm op Ubuntu?

A6.

npm is je toegangspoort tot het JavaScript‑ecosysteem. Hier zijn een paar dingen die je op Ubuntu kunt bouwen:

• Frontend‑apps met frameworks zoals React, Vue of Svelte
• Statische site‑generators zoals Next.js of Nuxt
• Backend‑API’s met Express of NestJS
• Aangepaste CLI‑tools
• Testomgevingen met Jest of Mocha

Door npm op Ubuntu te gebruiken, kun je de volledige kracht van het open‑source‑ecosysteem benutten om efficiënte, schaalbare en moderne applicaties te bouwen.

6. Samenvatting: npm onder de knie krijgen op Ubuntu

In dit artikel hebben we alles behandeld wat je moet weten om npm effectief te installeren en te gebruiken op Ubuntu. Van installatiemethoden tot basiscommando’s, hier is een korte samenvatting van de belangrijkste punten.

Belangrijkste punten

• Wat is npm? – Een pakketbeheerder die wordt meegeleverd met Node.js en de ontwikkelingsproductiviteit aanzienlijk verhoogt
• Hoe npm te installeren op Ubuntu: – Je kunt het installeren via de officiële repository, de NodeSource‑PPA of nvm, afhankelijk van je behoeften
• Kernfuncties: – Eenvoudige commando’s voor het installeren, verwijderen, bijwerken en beheren van afhankelijkheden
• Probleemoplossing: – Tips voor het oplossen van permissiefouten, versieconflicten en meer
• FAQ‑sectie: – Duidelijke antwoorden op veelvoorkomende vragen die zich voordoen tijdens ontwikkeling in de praktijk

Een opmerking voor beginners

Ubuntu en npm vormen een uitstekend duo voor moderne webontwikkeling. Hoewel je in het begin misschien fouten of verwarring tegenkomt, zal het oplossen van die problemen je begrip verdiepen en je helpen groeien als ontwikkelaar.

Het belangrijkste is om praktisch te experimenteren. Het uitvoeren van elk commando, het lezen van de output en leren van fouten zal snel je vertrouwen vergroten.

Dat is het einde van onze gids voor het gebruik van npm op Ubuntu. We hopen dat het je helpt een solide ontwikkelomgeving op te zetten en je leertraject te versnellen.

We blijven meer Linux‑tips en frontend‑ontwikkeltutorials delen, dus voel je vrij om deze site toe te voegen aan je bladwijzers of te delen op sociale media!