From 95af1b486ce440d22a353c054f62c217c3aa884e Mon Sep 17 00:00:00 2001 From: Soheil Nikroo <62501144+soheilnikroo@users.noreply.github.com> Date: Mon, 9 Jun 2025 14:44:05 +0330 Subject: [PATCH] sugguest using npm for package manager Since we use pnpm to host our Strapi with MySQL, and we face an error on loading the mysql2 package --- docusaurus/docs/cms/deployment.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docusaurus/docs/cms/deployment.md b/docusaurus/docs/cms/deployment.md index 22d127454d..8a28d3af1c 100644 --- a/docusaurus/docs/cms/deployment.md +++ b/docusaurus/docs/cms/deployment.md @@ -31,6 +31,10 @@ If you already created a content structure with the Content-Type Builder and add Another possible workflow is to first create the content structure locally, push your project to a git-based repository, deploy the changes to production, and only then add content to the production instance. ::: +:::caution +For self-hosted Kubernetes deployments, we recommend using **npm** rather than **pnpm**. `pnpm` aggressive hoisting of dependencies can break native modules, such as `mysql2`— that your application may rely on. `npm` flatter, more predictable `node_modules` layout helps ensure native packages load correctly. +::: + ## General guidelines ### Hardware and software requirements @@ -223,4 +227,4 @@ The following external guide(s), not officially maintained by Strapi, might also :::strapi Multi-tenancy If you're looking for multi-tenancy options, the Strapi Blog has a . -::: \ No newline at end of file +:::