Single machine deployment

This topic provides instructions for deploying updates to Magento 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.

For less technical users, i.e. business users, we recommend using the System Upgrade feature in the Admin.


This guide does not apply if you used git clone to install Magento. Contributing developers should use this guide to update their Magento installation.

Deployment steps

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

  2. Change directory to the Magento base directory:

    cd <Magento base directory>
  3. Enable maintenance mode using the command:

    bin/magento maintenance:enable
  4. Apply updates to Magento or its components using the following command pattern:

    composer require <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 Magento’s components with Composer:

    composer update
  6. Update the database schema and data:

    bin/magento setup:upgrade
  7. Compile the code:

    bin/magento setup:di:compile
  8. Deploy static content:

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

    bin/magento cache:clean
  10. Exit maintenance mode:

    bin/magento maintenance:disable

Alternative deployment strategies

In Magento 2.2, a near-zero downtime deployment model will be available for a variety of complex environments, including Magento Commerce Cloud.

Related topics