Instalasi

Menggunakan skrip mandiri

Anda dapat menginstal pnpm bahkan jika Anda tidak menginstal Node.js, menggunakan skrip berikut.

Di Windows

Menggunakan PowerShell:

iwr https://get.pnpm.io/install.ps1 -useb | iex

Pada sistem POSIX

curl -fsSL https://get.pnpm.io/install.sh | sh -

Jika anda tidak menginstal curl, Anda bisa menggunakan wget:

wget -qO- https://get.pnpm.io/install.sh | sh -

Di Linux Alpine

# bash
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.bashrc" SHELL="$(which bash)" bash -
# sh
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.shrc" SHELL="$(which sh)" sh -
# dash
wget -qO- https://get.pnpm.io/install.sh | ENV="$HOME/.dashrc" SHELL="$(which dash)" dash -

Prasyarat

Jika Anda tidak menggunakan skrip mandiri untuk menginstal pnpm, maka Anda harus memiliki Node.js (setidaknya v14) untuk diinstal di sistem Anda.

Menginstal versi tertentu

Sebelum menjalankan skrip instal, Anda dapat secara opsional menetapkan variabel env PNPM_VERSION untuk menginstal versi pnpm tertentu:

curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=<version> sh -

tip

Anda kemudian dapat menggunakan perintah pnpm env untuk menginstal Node.js.

Menggunakan Corepack

Sejak v16.13, Node.js mengirimkan Corepack untuk mengelola manajer paket. Ini adalah fitur eksperimental, jadi Anda harus mengaktifkannya dengan menjalankan:

corepack enable

Jika Anda menginstal Node.js menggunakan Homebrew, Anda harus menginstal corepack secara terpisah:

brew install corepack

Ini akan menginstal pnpm secara otomatis di sistem Anda. Namun, yang terinstal mungkin bukan pnpm versi terbaru. Untuk memperbarui, lihat versi pnpm yang terbaru dan jalankan perintah berikut:

corepack prepare pnpm@<version> --activate

Dengan Node.js v16.17 atau yang lebih baru, Anda dapat menginstal versi latest dari pnpm hanya dengan menyebutkan tag:

corepack prepare pnpm@latest --activate

Menggunakan npm

npm install -g pnpm

Menggunakan Homebrew

Jika anda sudah menginstal package manager tersebut, Anda dapat menginstal pnpm dengan menggunakan perintah berikut:

brew install pnpm

Menggunakan Scoop

Jika Anda sudah menginstal Scoop, Anda dapat menginstal pnpm dengan menggunakan perintah berikut:

scoop install nodejs-lts pnpm

tip

Apakah Anda ingin menggunakan pnpm di server CI? Lihat: Integrasi Berkelanjutan.

Kompatibilitas

Berikut adalah daftar versi pnpm sebelumnya masing-masing dengan dukungan versi Node.js.

Node.js	pnpm 4	pnpm 5	pnpm 6	pnpm 7
Node.js 10	✔️	✔️	❌	❌
Node.js 12	✔️	✔️	✔️	❌
Node.js 14	✔️	✔️	✔️	✔️
Node.js 16	?️	?️	✔️	✔️
Node.js 18	?️	?️	✔️	✔️

Pemecahan Masalah

Jika pnpm rusak dan Anda tidak dapat memperbaikinya dengan menginstal ulang, Anda mungkin perlu menghapusnya secara manual dari PATH.

Anggaplah Anda mengalami kesalahan berikut saat menjalankan pnpm install:

C:\src>pnpm install
internal/modules/cjs/loader.js:883
  throw err;
  ^



Error: Cannot find module 'C:\Users\Bence\AppData\Roaming\npm\pnpm-global\4\node_modules\pnpm\bin\pnpm.js'
←[90m    at Function.Module._resolveFilename (internal/modules/cjs/loader.js:880:15)←[39m
←[90m    at Function.Module._load (internal/modules/cjs/loader.js:725:27)←[39m
←[90m    at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:72:12)←[39m
←[90m    at internal/main/run_main_module.js:17:47←[39m {
  code: ←[32m'MODULE_NOT_FOUND'←[39m,
  requireStack: []
}

Pertama, coba cari lokasi pnpm dengan menjalankan: which pnpm. Jika Anda menggunakan Windows, jalankan perintah ini di Git Bash. Anda akan mendapatkan lokasi perintah pnpm, misalnya:

$ which pnpm
/c/Program Files/nodejs/pnpm

Sekarang setelah Anda tahu di mana CLI pnpm berada, buka direktori itu dan hapus file -file yang berhubungan dengan pnpm (pnpm.cmd, pnpx.cmd, pnpm, dll). Setelah selesai, instal pnpm lagi dan pnpm seharusnya berfungsi seperti yang diharapkan.

Menggunakan alias yang lebih pendek

pnpm mungkin sulit diketik, jadi Anda dapat menggunakan alias yang lebih pendek seperti pn.

Menambahkan alias permanen pada sistem POSIX

Cukup letakkan baris berikut ke .bashrc, .zshrcatau config.fish:

alias pn=pnpm

Menambahkan alias permanen di Powershell (Windows):

Di jendela Powershell dengan hak admin, jalankan:

notepad $profile.AllUsersAllHosts

Di file profile.ps1 yang terbuka, masukkan:

set-alias -name pn -value pnpm

Simpan file dan tutup jendela. Anda mungkin perlu menutup jendela Powershell yang terbuka agar alias dapat diterapkan.

Menghapus instalasi pnpm

Jika Anda perlu menghapus pnpm CLI dari sistem Anda dan file apa pun yang sudah ditulis ke disk Anda, lihat Menghapus Instalasi pnpm.