Magento Installation Guide


In this tutorial we will quickly go through the steps necessary to install the Magento Commerce application on one of our Magento Optimized hosting accounts.

Note: ProperHost customers are entitled to a free professional Magento installation as part of their Magento hosting package. To request an installation, just open a support ticket.

Step 1 - Log in Using SSH

Start by logging into your account using your favorite SSH client (we recommend PuTTY). If SSH is not enabled on your account, please open a support ticket.

Host Name: your domain name or server IP
Port: 22
Username: your account (cPanel) username
Password: your account (cPanel) password

Putty SSH Configuration
Figure 1: PuTTY SSH Configuration

See this knowledgebase article for detailed instructions on how to log in with SSH.


Step 2 - Download and Extract Files

Once connected to the server, first navigate to the directory where the store should be installed (usually this will be 'public_html' - e.g. type 'cd public_html'). Then run the following commands. Make sure to type them in exactly as they are listed below (tip: copy/paste). Enter each line separately, followed by [enter]. (You should replace "1.2.0.2" with the current version)

  1. wget http://www.magentocommerce.com/downloads/assets/1.2.0.2/magento-1.2.0.2.tar.gz
  2. tar -zxf magento-1.2.0.2.tar.gz
  3. mv magento/* magento/.htaccess magento/.htaccess.sample .
  4. rm -rf magento/ magento-1.2.0.2.tar.gz

All the files required by Magento are now uploaded to the server, and you may continue with the next step.

Step 3 - Set up the MySQL Database

Now you need to create a new MySQL database for your store. Log in to cPanel by following the instructions given in your Account Information email. Then click on the MySQL® Database Wizard icon. Type in a name for your new database (e.g. mystore) and click Next Step (see Figure 2). Now you need to assign a new user to your database. Type in a username and password then click Next Step. Finally, check the All Privileges checkbox and click Next Step to complete the database wizard.

You can now log out of cPanel and proceed to step 4.

Create a new database
Figure 2: Create a New Database

 

Step 4 - Magento Installation Wizard

Now point your browser at http://www.yourdomain/install.php to bring up the Magento Installation Wizard and follow the instructions. After you have accepted the license agreement and set your locale settings, you will have to enter the database details from step 3.

Database Connection

Fill in the database, username and password in the corresponding fields, leave the Host and Tables Prefix unchanged.

Remember that the MySQL database and user should always be prefixed by your cPanel username (e.g. john_dbname/john_dbuser)

Magento Installation Wizard: Database Connection
Figure 3: Configure Database Connection


Web Access Options

Check the option "Use Web Server (Apache) Rewrites" to enable search engine optimized URLs. If you want to specify another path for the admin login (default is http://yourdomain/admin/) you can enter a custom value in the Admin Path field. Leave the other options unchanged and then click Continue.

Magento Installation Wizard: Web Access Options
Figure 4: Web Access Options


Create an Admin Account

The final step is to create an admin user for your store backend. Fill in all the details as requested, then click Continue to complete the installation wizard.

Note: Leave the Encryption Key field empty to let the system automatically generate a key (recommended).

Create an Admin Account
Figure 5: Create an Admin Account


Installation Complete!

Congratulation! You have now successfully installed Magento. You may now log in to the store backend using the admin account created above.

If you have any comments or questions regarding this tutorial, feel free to contact us.

Also, be sure to check out our Magento Upgrade Guide for tips on how to keep your store up to date.

 


Was this answer helpful?