Medusa is an open-source headless commerce engine that enables developers to create amazing digital commerce experiences.

This repo is managed by the Medusa Community. Medusa does not provide official support for Docker, but we will accept fixes and documentation. Use at your own risk.

This project is inteded for development only at this time.

The files for both the Medusa server and the Storefront are loaded in Bind Mounts allowing you to change the server functionality and have the change be hot-reloaded onto your running containers.

To use Docker with Medusa, you should have created a Medusa project. Check out our Quickstart to get started.

Additionally, you should have docker and docker-compose installed on your system.

To set up Medusa in a development environment with Docker, you should copy files docker-compose.yml, docker-compose.override.yml, backend/develop.sh, and backend/Dockerfile` to your Medusa project.

Then build the images since they are not published on dockerhub. This is accomplished by adding the --build flag as shown below:

docker compose up --build

Having already built the Docker images you can run docker compose without the --build flag.

docker compose up

Your local Medusa setup is now running with each of the services occupying the following ports:

• Medusa Server: 9000
• Medusa Admin: 7000
• Storefront: 8000
• postgres: 5432
• redis: 6379

Note: If you change the dependencies of your projects by adding new packages you can simply rebuild that package with the same tag test and run docker compose up once again to update your environment.

To add seed data to your medusa store run this command in a seperate

docker exec medusa-server medusa seed -f ./data/seed.json

This repository and each of the services contain dockerfiles for both development and production, named Dockerfile and Dockerfile.prod respectively. The Dockerfile.prod copies the local files from disk and builds a production ready image based on your local development progress. Your specific needs for a production like container might differ from the Dockerfile.prod but it should provide a template and an idea of the requirements for each of the basic services.

To run the services in a production state docker compose is simply run with the docker-compose.production.yml file as well as the basic docker-compose.yml file as seen below. If you wish to build the production ready images and then start them run docker compose up with the --build flag as described above.

docker compose up -f docker-compose.yml -f docker-compose.production.yml up

docker-compose.production.yml contains production relevant overrides to the services described in the docker-compose.yml development file.

curl -X GET localhost:9000/store/products | python -m json.tool

After the seed script has run you will have the following things in you database:

• a User with the email: [email protected] and password: supersecret
• a Region called Default Region with the countries GB, DE, DK, SE, FR, ES, IT
• a Shipping Option called Standard Shipping which costs 10 EUR
• a Product called Cool Test Product with 4 Product Variants that all cost 19.50 EUR

Visit docs.medusa-commerce.com for further guides.

Website | Notion Home | Twitter | Docs