import TypeError from "../_sections/create-medusa-app-errors/typeerror.mdx" import OtherErrors from "../_sections/create-medusa-app-errors/other-errors.mdx" import NextjsError from "../_sections/nextjs/cma-option.mdx" import InvalidTokenError from "../_sections/create-medusa-app-errors/no-browser-token-error.mdx" import DockerSection from "../_sections/database-errors/docker.mdx" import DbUrlError from "../_sections/create-medusa-app-errors/db-url-error.mdx" import ForwardingError from "../_sections/create-medusa-app-errors/forwarding.mdx" import SaslSection from '../_sections/database-errors/sasl.mdx' import ModuleXErrorSection from '../_sections/common-installation-errors/module-x-error.mdx' import Node25Troubleshooting from "../_sections/create-medusa-app-errors/nextjs-node-25.mdx"

export const metadata = { title: Common create-medusa-app Errors, }

{metadata.title}

This troubleshooting guide covers common errors you may encounter when using the create-medusa-app command to set up a new Medusa application and how to resolve them.

General Errors Connecting to Database

<SaslSection />

---

TypeError: cmd is not a function

<TypeError />

---

Errors when using VSCode or GitHub Codespaces

<ForwardingError />

---

Invalid Token Error with --no-browser Option

<InvalidTokenError />

---

Can't Connect to PostgreSQL Docker Container

<DockerSection />

---

Can't connect to database with --db-url option

<DbUrlError />

---

Can't Access Next.js Starter Storefront

<NextjsError />

---

Issues when installing with Node v25+

<Node25Troubleshooting />

---

Resolve "Cannot find module X" Errors

<ModuleXErrorSection />

---

Other Errors

<OtherErrors />