Instalasi

Prasyarat

Jika anda tidak menggunakan skrip khusus atau @pnpm/exe untuk menginstal pnpm, maka anda harus sudah menginstal Node.js (paling tidak v16.14) di sistem anda.

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 -

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:

info

Jika Anda telah menginstal Node.js dengan pnpm env Corepack tidak akan diinstal pada sistem Anda, Anda harus menginstalnya secara terpisah. Lihat #4029.

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

Kami menyediakan dua paket pnpm CLI, pnpm dan @pnpm/exe.

• pnpm adalah versi biasa pnpm, yang memerlukan Node.js untuk bisa dijalankan.
• @pnpm/exe dikemas dengan Node.js ke dalam executable, sehingga dapat digunakan pada sistem yang tidak menginstal Node.js.

npm install -g pnpm

atau

npm instal -g @pnpm/exe

Menggunakan Homebrew

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

brew install pnpm

Menggunakan Winget

Jika Anda sudha menginstal Winget, Anda dapat menginstal pnpm dengan menggunakan perintah berikut:

winget install pnpm

Menggunakan Scoop

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

scoop install nodejs-lts pnpm

Menggunakan Choco

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

choco install pnpm

Menggunakan Volta

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

volta install 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 5	pnpm 6	pnpm 7	pnpm 8
Node.js 12	✔️	✔️	❌	❌
Node.js 14	✔️	✔️	✔️	❌
Node.js 16	?️	✔️	✔️	✔️
Node.js 18	?️	✔️	✔️	✔️
Node.js 20	?️	?	✔️	✔️

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 pnpm

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