From 4c6c26a7e84bc0ef38007aef9a152f831ed17b9a Mon Sep 17 00:00:00 2001
From: Brandon Cheng <gluxon@users.noreply.github.com>
Date: Tue, 10 Feb 2026 20:19:43 -0500
Subject: [PATCH] fix: disable global virtual store during `pnpm deploy`
 (#10577)

---
 .changeset/bold-words-give.md                             | 8 ++++++++
 pkg-manager/plugin-commands-installation/src/install.ts   | 1 +
 .../plugin-commands-installation/src/installDeps.ts       | 1 +
 releasing/plugin-commands-deploy/src/deploy.ts            | 6 ++++++
 4 files changed, 16 insertions(+)
 create mode 100644 .changeset/bold-words-give.md

diff --git a/.changeset/bold-words-give.md b/.changeset/bold-words-give.md
new file mode 100644
index 0000000000..561d9e5329
--- /dev/null
+++ b/.changeset/bold-words-give.md
@@ -0,0 +1,8 @@
+---
+"@pnpm/plugin-commands-installation": patch
+"@pnpm/plugin-commands-deploy": patch
+pnpm: patch
+---
+
+When the [`enableGlobalVirtualStore`](https://pnpm.io/settings#enableglobalvirtualstore) option is set, the `pnpm deploy` command would incorrectly create symlinks to the global virtual store. To keep the deploy directory self-contained, `pnpm deploy` now ignores this setting and always creates a localized virtual store within the deploy directory.
+
diff --git a/pkg-manager/plugin-commands-installation/src/install.ts b/pkg-manager/plugin-commands-installation/src/install.ts
index 5cb6741619..ecaad60ae4 100644
--- a/pkg-manager/plugin-commands-installation/src/install.ts
+++ b/pkg-manager/plugin-commands-installation/src/install.ts
@@ -274,6 +274,7 @@ export type InstallCommandOptions = Pick<Config,
 | 'deployAllFiles'
 | 'depth'
 | 'dev'
+| 'enableGlobalVirtualStore'
 | 'engineStrict'
 | 'excludeLinksFromLockfile'
 | 'frozenLockfile'
diff --git a/pkg-manager/plugin-commands-installation/src/installDeps.ts b/pkg-manager/plugin-commands-installation/src/installDeps.ts
index 645790de45..93d78d2af0 100644
--- a/pkg-manager/plugin-commands-installation/src/installDeps.ts
+++ b/pkg-manager/plugin-commands-installation/src/installDeps.ts
@@ -57,6 +57,7 @@ export type InstallDepsOptions = Pick<Config,
 | 'dedupePeerDependents'
 | 'depth'
 | 'dev'
+| 'enableGlobalVirtualStore'
 | 'engineStrict'
 | 'excludeLinksFromLockfile'
 | 'global'
diff --git a/releasing/plugin-commands-deploy/src/deploy.ts b/releasing/plugin-commands-deploy/src/deploy.ts
index 28fa3aaaf0..6cf920c714 100644
--- a/releasing/plugin-commands-deploy/src/deploy.ts
+++ b/releasing/plugin-commands-deploy/src/deploy.ts
@@ -170,6 +170,9 @@ export async function handler (opts: DeployOptions, params: string[]): Promise<v
     // the deploy directory. It's also just weird to include empty importers
     // that don't matter to the filtered lockfile generated for pnpm deploy.
     pruneLockfileImporters: true,
+    // The node_modules for a pnpm deploy should be self-contained. The global
+    // virtual store would create symlinks outside of the deploy directory.
+    enableGlobalVirtualStore: false,
     depth: Infinity,
     hooks: {
       ...opts.hooks,
@@ -266,6 +269,9 @@ async function deployFromSharedLockfile (
       allProjectsGraph: undefined,
       selectedProjectsGraph: undefined,
       rootProjectManifest: deployFiles.manifest,
+      // The node_modules for a pnpm deploy should be self-contained. The global
+      // virtual store would create symlinks outside of the deploy directory.
+      enableGlobalVirtualStore: false,
       rootProjectManifestDir: deployDir,
       dir: deployDir,
       lockfileDir: deployDir,