Magento Installation Guide
Note: This page is being deprecated. Up-to-date installation information for Magento Community Edition (CE) and Enteprise Edition (EE) can be found at the new location here. Please update your bookmarks. This page will be removed in the near future.-----------------------------
- Please refer to Magento's system requirements to ensure you have the appropriate platform and environment set up. If you attempted to install Magento and the installation wizard suggested to use the PHP-CGI workaround, please click here.
- Download the .zip or .tar.gz file from the Magento website and decompress it.
- Upload the Magento web files to your web server via FTP (if you have SSH access and are comfortable with the command line, check out this wiki post)
- Create a MySQL database and user/password for Magento This step varies by hosting provider and is out of the scope of this document. Consult your provider's support/documentation for instructions on how to do this.
- Ensure that the file magento/var/.htaccess, the directories magento/app/etc, magento/var, and all the directories under magento/media are writable by the web server. To do so, navigate to the directory with your FTP client. Then locate the function "Change Permissions" or "Change Mode" in your FTP client and select it. Once you find the function, you must set the permissions so the web server can write to this file. There are two typical ways of representing file permissions in Linux:
- As a number (eg, 755)
- As a series of permissions categorized into user, group, and other
- Use your web browser to surf to the Magento installation wizard. If you've uploaded the Magento files to http://www.example.com/magento/, then the wizard will be located here: http://www.example.com/magento/install/.
- Once in the wizard, you can configure various system-level settings that are required for Magento to function. Most options will be intelligently guessed for you, but you're free to override any settings that don't look right. At the very least, change the database parameters in the first box “Database connection” to match those of the database you set up in Step 3.
- Success! You've completed a basic Magento install. You can now visit the administration backend and begin configuring your new online store.
- UPDATE: If you have installed Version 1.0.19700, you should follow the instructions to install the patch which fixes a known issue with the compare products feature.
- ** IMPORTANT: Catalog price rules and many other features in Magento require periodical execution of scheduled task. Please refer to this article for information on cronjob setup: http://www.magentocommerce.com/wiki/how_to_setup_a_cron_job
If your FTP client uses the first representation, set the permissions on each directory to be 777, or 0777. If your FTP client uses the second representation, set the permissions as shown in the image below. http://www.magentocommerce.com/wiki/magento_filesystem_permissions
UPDATE: Please use the Magento Install / Setup Forum to report and discuss installation issues.