DocumentationCommerceConfiguration Guide

Single-machine deployment

Last update: Wed May 17 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Experienced
  • Admin
  • Developer

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.

Assumptions

  • You installed Commerce using Composer.
  • You are directly applying updates to the server.
WARNING
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
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c