Close [x]

Install by cloning repositories

Edit this page on GitHub

Install sample data by cloning repositories

This topic discusses how to get the Magento sample data if you cloned the Magento GitHub repository. This method is intended only for contributing developers (that is, developers who plan to contribute to the Magento 2 codebase).

If you鈥檙e not a contributing developer, choose one of the other options displayed in the table of contents on the left side of the page.

Contributing developers can use this method of installing sample data only if all of the following are true:

You can use sample data with either the develop branch (more current) or a released branch (such as 2.0 or 2.0.1 (more stable)). We recommend you use a released branch because it's more stable. If you're contributing code to the Magento 2 repository and you need the most recent code, use the develop branch.

Regardless of the branch you choose, you must clone the corresponding branch of the Magento 2 GitHub repository. For example, sample data for the develop branch can be used only with the Magento 2 develop branch.

See the following sections:

Clone the sample data repository

This section discusses how to install Magento sample data by cloning the sample data repository. You can clone the sample data repository in any of the following ways:

Clone with SSH

To clone the Magento sample data GitHub repository using the SSH protocol:

  1. In a web browser, go to the Magento sample data repository.
  2. Next to the name of the branch, click SSH from the list.

  3. Click Copy to clipboard

    The following figure shows an example.

    Clone the Magento GitHub repository using SSH

  4. Change to your web server鈥檚 docroot directory.

    Typically, for Ubuntu, it鈥檚 /var/www and for CentOS it鈥檚 /var/www/html.

    Need help locating the docroot?

  5. Enter git clone and paste the value you obtained from step 1.

    An example follows:

    git clone git@github.com:magento/magento2-sample-data.git

  6. Wait for the repository to clone on your server.

    If the following error displays, make sure you shared your SSH key with GitHub: 

    Cloning into 'magento2'...
Permission denied (publickey).
fatal: The remote end hung up unexpectedly
  7. Change to the <your Magento sample data clone dir>/dev/tools directory.

  8. Enter the following command:

    php -f build-sample-data.php -- --ce-source="<your Magento CE install dir>"

  9. Wait for the command to complete.

  10. See Set file system permissions and ownership.

Clone with HTTPS

To clone the Magento sample data GitHub repository using the HTTPS protocol:

  1. In a web browser, go to the Magento sample data repository.
  2. On the right side of the page, under the clone URL field, click HTTPS.

  3. Click Copy to clipboard.

    The following figure shows an example.

    Clone the Magento GitHub repository using HTTPS

  4. Change to your web server鈥檚 docroot directory.

    Typically, for Ubuntu, it鈥檚 /var/www and for CentOS it鈥檚 /var/www/html.

  5. Enter git clone and paste the value you obtained from step 1.

    An example follows:

    git clone https://github.com/magento/magento2-sample-data.git
  6. Wait for the repository to clone on your server.
  7. Change to the <your Magento sample data clone dir>/dev/tools directory.

  8. Enter the following command:

    php -f build-sample-data.php -- --ce-source="<your Magento CE install dir>"

    For example,

    php build-sample-data.php -- --ce-source="/var/www/magento2"
  9. Wait for the command to complete.
  10. See the next section.

Set file system ownership and permissions

Because the php build-sample-data.php script creates symlinks between the sample data repository and your Magento 2 repository, you must set file system permissions and ownership in the sample data repository. Failure to do so results in errors accessing the storefront.

To set file system permissions and ownership on the sample data repository:

  1. Change to your sample data clone directory.

  2. Set ownership:

    chown -R :<your web server group name> .

    Typical examples:

    CentOS: chown -R :apache .

    Ubuntu: chown -R :www-data .

  3. Set permissions:

    find . -type d -exec chmod 770 {} \; && find . -type f -exec chmod 660 {} \;

    If you must enter the commands as sudo, use:

    sudo find . -type d -exec chmod 770 {} \; && sudo find . -type f -exec chmod 660 {} \;

  4. Clear static files:

    cd <your Magento CE install dir>/var
rm -rf cache/* page_cache/* generation/*