Instalação

Usando um script

Node.js is not preinstalled

On POSIX systems, you may install pnpm even if you don't have Node.js installed, using the following script:

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

If you don't have curl installed, you would like to use wget:

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

You may use the pnpm env command then to install Node.js.

Node.js is preinstalled

On Linux or macOS:

curl -f https://get.pnpm.io/v6.16.js | node - add --global pnpm

No Windows (PowerShell):

(Invoke-WebRequest 'https://get.pnpm.io/v6.16.js' -UseBasicParsing).Content | node - add --global pnpm

O script é assinado. Veja como verificar.

Usando npm

npm install -g pnpm

Usando npx

npx pnpm add -g pnpm

Atualizando

Once you have installed pnpm, there is no need to use other package managers to update it. You can upgrade pnpm using itself, like so:

pnpm add -g pnpm

tip

Do you wanna use pnpm on CI servers? See: Continuous Integration.

Compatibilidade

Here is a list of past pnpm versions with respective Node.js version support.

Node.js	pnpm 1	pnpm 2	pnpm 3	pnpm 4	pnpm 5	pnpm 6
Node.js 4	✔️	❌	❌	❌	❌	❌
Node.js 6	✔️	✔️	❌	❌	❌	❌
Node.js 8	✔️	✔️	✔️	❌	❌	❌
Node.js 10	✔️	✔️	✔️	✔️	✔️	❌
Node.js 12	❌	❌	✔️	✔️	✔️	✔️
Node.js 14	❌	❌	✔️	✔️	✔️	✔️
Node.js 16	?	?	?️	?️	?️	✔️

Solução de Problemas

Se o pnpm falhar, e não for resolvido por meio de uma reinstalação, você pode precisar removê-lo manualmente do PATH.

Assumindo que você têm o seguinte erro ao rodar 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: []
}

Primeiro, tente encontrar a localização do pnpm rodando: which pnpm. Se você usar Windows, execute este comando no Git Bash. Você irá ver a localização do comando pnpm, como:

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

Agora que você sabe onde está localizado o pnpm, abra este diretório e remova qualquer arquivo relacionado ao pnpm (pnpm.cmd, pnpx.cmd, pnpm, etc). Então, instale o pnpm novamente, e ele deve funcionar como esperado.

Uninstalling pnpm

Se você precisar remover o pnpm de seu sistema, assim como quaisquer arquivos relacionados, veja Desinstalando pnpm.