Instalasi

Prasyarat

If you don't use the standalone script or @pnpm/exe to install pnpm, then you need to have Node.js (at least v16.14) to be installed on your system.

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

We provide two packages of pnpm CLI, pnpm and @pnpm/exe.

• pnpm is a ordinary version of pnpm, which needs Node.js to run.
• @pnpm/exe is packaged with Node.js into an executable, so it may be used on a system with no Node.js installed.

npm install -g pnpm

or

npm install -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 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.