Magento Installation Cheat Sheet

This article is most helpful for users who have installed Magento before and just need a reminder of the major steps in the process. If this is your first Magento installation, please refer to the Magento Installation Guide instead for fuller descriptions and troubleshooting information. Links to additional installation instructions are provided at the end.

System Requirements

See Magento System Requirements.

For evaluation and development purposes, Magento can be run locally on a PC or Mac using a local LAMP stack (like XAMPP, WAMP or MAMP). Windows and Mac servers are NOT supported production environments, however. Please see the links at the bottom of this document for additional considerations when installing to your localhost.

Installing Magento

These instructions document the default installation for Magento. At the end, Magento will be installed without sample data to a directory called magento on your web server. There are four main steps covered here:

Step 1—Download Magento

Step 2—Set file system permissions and ownership

See Before You Install Magento: Recommended File System Ownership and Privileges.

Step 3—Create your store database

  1. Create an empty MySQL database for your store
    This step varies by hosting provider and is out of the scope of this document. Consult your System Administrator or your web host's support/documentation for instructions on how to do this. PHPmyAdmin or the MySQL command line are the most commonly used tools/methods for creating and managing a MySQL database
  2. Create a database user with full privileges to the database
  3. Make note of the database name (dbname), db user (dbuser), db user password (dbpassword)
  4. If you want to load sample data, you must do it now, before you run the setup Wizard in the next step

? More information: Installing the Sample Data for Magento

Step 4—Run the web-based Setup Wizard

See Installing Magento CE 1.8 or EE 1.13.

Magento stores this set up information in the file app/etc/local.xml. If you’d like to run through the Setup Wizard again you do not have to download all the Magento files again. Just delete the local.xml file and any files and directories in the var/ directory and go back to http://www.yourDomain.com/magento with your browser. The Setup Wizard will run automatically again. (Why does this work? The Setup Wizard writes the values you provide during the setup process to the local.xml file and it will not run if it finds a local.xml file already. The var folder contains cached session information from the frontend and will have cached any previous settings, so deleting these files will prevent the incorrect cached content from being used.)

Success!

After you finish the set up wizard, you will be redirected to the Magento storefront. You can access the Admin Panel and start adding categories and products.

More Information

Standard Installation
Magento Installation Guide
Installing Sample Data for Magento
System Requirements
System Test Script
Other Installation Options
[wiki] Installing Magento via SSH
[wiki] Installing on PC-based localhost using XAMPP and WAMP
[wiki] Common Installation Problem in Windows
[wiki] Installing on OSX-based localhost
[3rd party] Installing Magento Stand-Alone on OSX
Installing at Specific Hosts
[wiki] Installing Magento on Slicehost with Ubuntu
[wiki] Installing with Lighttpd and FastCGI
[wiki] Media Temple Magento Installation Guide - Grid Service
[wiki] MediaTemple Magento Installation Guide - Dedicated-Virtual Server
[forum] One and One (1&1) Hosting Install Guide Thread (shared server)
[forum] Magento on a VMWare Version of Ubunto 7.10
[forum] Barebones Guide: 1&1 Shared Hosting Installation (North America)
[3rd party] Crucial Web Hosting Magento Install Guide
[3rd party] Magento E-Commerce Solution On Debian Etch
[3rd party] Magento Installation Guide for Dreamhost
International
[3rd party] German Install Guide
[3rd party] German Install Guide (using xampplite)
[3rd party] Installation on Heart Internet UK Hosting
[3rd party] How to install Magento on MacOSX in French

Do you have a favorite online installation tutorial? Please PM me--kara or email me at kara at magento.com.

Discussion:

RSS: New Article posts

Explore the Knowledge Base