Install using Composer
This section discusses how to install sample data if you got the Magento software in any of the following ways:
-
Downloaded a compressed archive from Magento.
If you downloaded an archive from Github, this method won’t work because the
composer.jsonfile doesn’t contain therepo.magento.comURL. -
Used
composer create-project
You can use this method of getting sample data for both Magento Open Source or Magento Commerce, but you must use the same authentication keys you used to install Magento.
If you encounter errors, such as Could not find package... or ...no matching package found..., make sure there aren’t any typos in your command. If you still encounter errors, you may not have access to the right Composer repositories, especially if your using Magento Commerce. Contact Magento support for help.
You can use Composer to install sample data either before or after installing Magento; however, there might be additional tasks.
If you’re a contributing developer, refer to Install by cloning repositories.
Do not install sample data if your Magento application is set for production mode. Switch to developer mode first. Installing sample data in production mode fails.
To install sample data using the command line, enter the following command as the Magento file system owner:
php <your Magento install dir>/bin/magento sampledata:deploy
If you’re installing sample data after installing Magento, you must also run the following command to update the database and schema:
php <your Magento install dir>/bin/magento setup:upgrade
You are required to authenticate to complete the action.
Authentication error
The following authentication error might display:
[Composer\Downloader\TransportException]
The 'https://repo.magento.com/packages.json' URL required authentication.
You must be using the interactive console to authenticate
If the error displays, change to your Magento installation directory and run composer update, which will prompt you for your authentication keys.
Install the Magento software
After sample data installation is complete, install the Magento software using the command line.