できない.dev

Corepack「EACCES: permission denied, symlink」の原因と直し方

EACCES: permission denied, symlink は、シムの置き場所を書き込める場所に変えれば直る。
corepack enable は既定で Node.js と同じ bin にシムを作るので、一般ユーザーでは書き込めない。

公開: 更新:

症状できない · exit 1
corepack enable
…
Internal Error: EACCES: permission denied, symlink '../lib/node_modules/corepack/dist/pnpm.js' -> '/usr/local/bin/pnpm'
    at async Object.symlink (node:internal/fs/promises:1001:10)
    at async EnableCommand.generatePosixLink (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:14322:5)
    at async Promise.all (index 0)
解決後できた · exit 0
corepack enable

2026-11-08 に node:22-bookworm-slim(Corepack 0.36.0 / Node.js 22.23.4) で実際に打って取った出力。検証環境の詳細

要約

corepack enable は、pnpm や yarn を呼び出すシム(中継用のシンボリックリンク)を node と同じ bin ディレクトリに作る。
そこが root 所有だと、一般ユーザーでは次のエラーになり、終了コード 1 で終わる。

Internal Error: EACCES: permission denied, symlink '../lib/node_modules/corepack/dist/pnpm.js' -> '/usr/local/bin/pnpm'

公式の node:22-bookworm-slim イメージ(Node.js 22.23.4・Corepack 0.36.0)に --user node を付けて実行すると、この表示で止まった。
シムを置く場所を書き込めるディレクトリに変えるか、root で実行すれば直る。

実行例

node:22-bookworm-slim のコンテナで一般ユーザーが corepack enable を打つと、/usr/local/bin/pnpm へのリンク作成で EACCES になり、終了コード 1 で止まった。
~/.local/bin を先に作って --install-directory で指定すると終了コード 0 になり、pnpm --version も版を返した。

$ node --version
v22.23.4
$ corepack --version
0.36.0
$ corepack enable
Internal Error: EACCES: permission denied, symlink '../lib/node_modules/corepack/dist/pnpm.js' -> '/usr/local/bin/pnpm'
    at async Object.symlink (node:internal/fs/promises:1001:10)
    at async EnableCommand.generatePosixLink (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:14322:5)
    at async Promise.all (index 0)
    at async EnableCommand.execute (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:14303:5)
    at async EnableCommand.validateAndExecute (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:1352:26)
    at async _Cli.run (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:2462:22)
    at async Object.runMain (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:14832:19)
$ echo $?
1
$ corepack enable --install-directory ~/.local/bin
Internal Error: ENOENT: no such file or directory, lstat '/home/node/.local'
    at Object.realpathSync (node:fs:2801:29)
    at EnableCommand.execute (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:14289:43)
    at EnableCommand.validateAndExecute (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:1352:37)
    at /usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:2462:51
    at noopCaptureActivator (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:2687:14)
    at _Cli.run (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:2462:28)
    at Object.runMain (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:14832:29)
    at Object.<anonymous> (/usr/local/lib/node_modules/corepack/dist/corepack.js:4:31)
    at Module._compile (node:internal/modules/cjs/loader:1781:14)
    at Object..js (node:internal/modules/cjs/loader:1913:10)
$ echo $?
1
$ mkdir -p ~/.local/bin
$ corepack enable --install-directory ~/.local/bin
$ echo $?
0
$ export PATH="$HOME/.local/bin:$PATH"
$ pnpm --version
Downloading the pnpm 12.18.0 binary for linux-x64...
12.18.0
$ echo $?
0
$ ls ~/.local/bin
pnpm
pnpx
yarn
yarnpkg
$ corepack enable
$ echo $?
0
$ ls -l /usr/local/bin/pnpm /usr/local/bin/yarn
lrwxrwxrwx 1 root root 41 Nov  7 22:56 /usr/local/bin/pnpm -> ../lib/node_modules/corepack/dist/pnpm.js
lrwxrwxrwx 1 root root 41 Nov  7 22:56 /usr/local/bin/yarn -> ../lib/node_modules/corepack/dist/yarn.js
$ pnpm --version
12.18.0
$ echo $?
0

— 2026-11-08 時点の出力

検証環境Node.js 22.23.4 / npm 10.9.9 / Corepack 0.36.0 / 2026-11-08 検証
検証日
実行環境
node:22-bookworm-slim Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 22.23.4
  • npm 10.9.9
  • Corepack 0.36.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. --install-directory で自分の bin に作る

--install-directory は、シムを作る場所を指定するオプションである(Corepack の README(新しいタブで開く))。
指定先のディレクトリは先に作っておく。
存在しないディレクトリを渡すと、ENOENT: no such file or directory, lstat で終了コード 1 になった。

mkdir -p ~/.local/bin
corepack enable --install-directory ~/.local/bin
export PATH="$HOME/.local/bin:$PATH"
pnpm --version

この手順では ~/.local/bin に pnpm・pnpx・yarn・yarnpkg の 4 つのリンクができ、pnpm --version が終了コード 0 で版を返した。
export の行は、シェルの設定ファイルにも書いておく。

2. Dockerfile では root のうちに有効にする

イメージを作るときは、ユーザーを切り替える前に実行する。

FROM node:22-bookworm-slim
RUN corepack enable
USER node

RUN の時点では root なので、リンクは /usr/local/bin にできる。
USER node に切り替えた後も、そのリンクを通して pnpm と yarn を呼べる。

手元の端末で起きたとき

/usr/local に入れた Node.js を使っているなら、sudo corepack enable のように root 権限で実行してもリンクができる。
管理者権限を使いたくなければ、解決策 1 の手順で自分のホームの下に作る。

よくある原因

  1. Node.js が /usr/local のような root 所有の場所に入っている。
    Docker の公式イメージもこの配置で、一般ユーザーは /usr/local/bin にリンクを作れない。
  2. Dockerfile で USER node に切り替えた後に corepack enable を書いている。
    同じイメージでも root のまま実行すると、/usr/local/bin/pnpm と /usr/local/bin/yarn のリンクができて終了コード 0 になった。