Single-machine deployment

This topic provides instructions for deploying updates to Commerce on a production server using the command line. This process applies to technical users responsible for stores running on a single machine with some themes and locales installed.


  • You installed Commerce using Composer.
  • You are directly applying updates to the server.
This guide does not apply if you used git clone to install Commerce.
Contributing developers should use [this guide][install] to update their Commerce installation.

Deployment steps

  1. Log in to your production server as, or switch to, the file system owner.

  2. Change directory to the Commerce base directory:

    code language-bash
    cd <Commerce base directory>
  3. Enable maintenance mode using the command:

    code language-bash
    bin/magento maintenance:enable
  4. Apply updates to Commerce or its components using the following command pattern:

    code language-bash
    composer require-commerce <package> <version> --no-update

    package: The name of the package you want to update.

    For example:

    • magento/product-community-edition
    • magento/product-enterprise-edition

    version: The target version of the package you want to update.

  5. Update components with Composer:

    code language-bash
    composer update
  6. Update the database schema and data:

    code language-bash
    bin/magento setup:upgrade
  7. Compile the code:

    code language-bash
    bin/magento setup:di:compile
  8. Deploy static content:

    code language-bash
    bin/magento setup:static-content:deploy
  9. Clean the cache:

    code language-bash
    bin/magento cache:clean
  10. Exit maintenance mode:

    code language-bash
    bin/magento maintenance:disable