Built by






Last updated

Nov 9, 2022, 06:19:03 AM2 years ago

Medusa Strapi Plugin

Setting up your store

  • Initialize a Copy to clipboardmedusa project by using a starter
    yarn create medusa-app
    npx create-medusa-app
  • Choose Copy to clipboardmedusa-starter-default
    ? Which Medusa starter would you like to install?
    ❯ medusa-starter-default
  • Pick any storefront starter
    Which storefront starter would you like to install?
    ❯ Gatsby Starter
    Next.js Starter
  • Make sure Copy to clipboardredis is installed and running
    $ redis-cli> ping
  • Go to backend directory.
    cd <Your project name>/backend
  • Make sure your packages version in Copy to clipboardpackage.json match this -
    "@medusajs/medusa": "^1.1.49",
    "@medusajs/medusa-cli": "^1.1.22",
    "medusa-fulfillment-manual": "^1.1.26",
    "medusa-interfaces": "^1.1.27",
    "medusa-payment-manual": "^1.0.8",
    "medusa-payment-stripe": "^1.1.30",
    "mongoose": "^5.13.3",
    "typeorm": "^0.2.36"
  • Edit Copy to clipboardmedusa-config.js. Navigate to the end of file and make sure this line is not commented out -
    redis_url: REDIS_URL,
  • In the same file, add this object to plugins array -
    resolve: `medusa-plugin-strapi`,
    options: {
    strapi_medusa_user: 'medusa_user',
    strapi_medusa_password: 'medusaPassword1',
    strapi_url: '',
    strapi_port: '1337'
  • Create and navigate to Copy to clipboardplugins directory and pull Copy to clipboardmedusa-plugin-strapi
    cd plugins
    git clone https://github.com/Deathwish98/medusa-plugin-strapi.git
  • Install dependencies and build project files
    cd medusa-plugin-strapi
    npm install
    npm run build
  • Start medusa server from Copy to clipboardbackend directory
    cd ../../
    npm run seed
    npm run start
Your local Medusa server should now be running on port 9000.

Setting up strapi

This plugin assumes that you are familiar with strapi. If you have not used it before, visit the official docs for more info -
  • Create a new strapi project using our template.
    npx create-strapi-app@3.6.8 strapi-medusa --template https://github.com/Deathwish98/strapi-medusa-template.git
    yarn create strapi-app strapi-medusa --template https://github.com/Deathwish98/strapi-medusa-template.git
  • Start strapi server.
    npm run develop <---- For development purposes
    npm run start
    NOTE: If you are using Copy to clipboardSQLite there is a known Copy to clipboardknex.js bug -
    error KnexTimeoutError: Knex: Timeout acquiring a connection. The pool is probably full. Are you missing a .transacting(trx) call?
    It appears after running Copy to clipboardnpm run develop for the first time . Just run the command again and it should disappear.
Visit docs.medusa-commerce.com for further guides.

Build your own plugins

Develop your own plugins with our API to speed up your processes.

Make your plugin available via npm for it to be shared in our Plugin Library with the broader Medusa community.