How to Install OpenCart on CentOS 7
Updated by Jonathan Chun Written by Jonathan Chun
What is OpenCart?
OpenCart is free open source ecommerce platform for online merchants. OpenCart provides a professional and reliable foundation from which to build a successful online store. This foundation appeals to a wide variety of users; ranging from seasoned web developers looking for a user-friendly interface to use, to shop owners just launching their business online for the first time. OpenCart has an extensive amount of features that gives you a strong hold over the customization of your store. With OpenCart’s tools, you can help your online shop live up to its fullest potential.
Before You Begin
You should set up LAMP on CentOS 7.
Install the Extra Packages for Enterprise Linux (EPEL) repository. sudo yum install epel-release
Make sure your server packages are up to date. sudo yum update
Install the unzip utility. sudo yum install unzip
Make sure that you have the following PHP extensions/modules installed (They should be installed by default on almost all PHP installations): - Curl - Zip - Zlib - GD Library - Mcrypt - Mbstrings - Xml
You can install them by running the following commands:
sudo yum install php-mcrypt curl zlib php-gd php-mbstring php-xml php-mysql
Create a Database and User
You will need to make sure you have a MySQL database and a database user set up for OpenCart. To create a database and a database user, please complete the following instructions:
Login to MySQL/MariaDB:
mysql -u root -p
Enter your MySQL/MariaDB root password when prompted. You should now see a MySQL prompt similar to
Create a new database and user with permissions to use it for OpenCart:
create database opencart; grant all on opencart.* to 'ocuser' identified by 'yourpassword'; flush privileges;
In the above example,
opencartis the name of the database,
ocuserthe user, and
yourpassworda strong password.
Download OpenCart and configure permissions
Issue the following commands to download and unpack OpenCart into your web root directory:
cd /var/www/html/example.com/public_html/ curl -OL https://github.com/opencart/opencart/releases/download/184.108.40.206/220.127.116.11-compiled.zip unzip 18.104.22.168-compiled.zip 'upload/*' cp upload/config-dist.php upload/config.php cp upload/admin/config-dist.php upload/admin/config.php sudo chown -R apache:apache upload shopt -s dotglob mv upload/* . rm -rf upload
In the above example, replace
/var/www/html/example.com/public_html/ with your virtual host’s web root and
22.214.171.124-compiled.zip with the file name of the latest OpenCart release.
NoteYou can find the latest version of OpenCart from their Download Page.
Next, run the following commands to make sure these directories are writable.
chmod 0755 system/storage/cache/ chmod 0755 system/storage/logs/ chmod 0755 system/storage/download/ chmod 0755 system/storage/upload/ chmod 0755 system/storage/modification/ chmod 0755 image/ chmod 0755 image/cache/ chmod 0755 image/catalog/ chmod 0755 config.php chmod 0755 admin/config.php
Run the OpenCart Installer
Visit your website in your browser. You should be redirected to the OpenCart Installer in a page that looks like this:
Press CONTINUE and you will see the Pre-Installation page.
Make sure that you see the green checkmark for every section before proceeding. If you see any red marks, please go back and make sure all of the instructions in this guide were followed properly. Once you’ve confirmed that every section has a green checkmark, press the CONTINUE button to see the OpenCart configuration page:
Here, select the MySQLi driver and fill out the form with the relevant information from the Create a Database and User section of this guide. You also need to select a username and password for the default administrator account for this OpenCart installation.
Finally, press the CONTINUE button and you should now see the Installation complete screen. You will also see a warning box telling you to remove your installation directory. We can do this by going back to your web root directory and running:
rm -rf install
Once you’ve done that, the installation is complete. Browse to
In the above example,
example.com is your domain name.
You can now login using the administrator account details you entered previously.
Recommended Next Steps
Now that you have your OpenCart installation up and running, there are a few more steps that we recommend. Because of the security-sensitive nature of ecommerce websites, you will want to make sure your system is secure.
Make sure you follow our Securing Your Server guide.
Follow the Basic Security Practices from the OpenCart documentation.
Install vQmod if you wish to use 3rd party extensions.
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
- OpenCart on CentOS 6
- OpenCart on Fedora 15 - Deprecated
- OpenCart on Debian 6 (Squeeze) - Deprecated
- Websites with Nginx on CentOS 5 - Deprecated
- osCommerce on Ubuntu 9.10 (Karmic) - Deprecated
This guide is published under a CC BY-ND 4.0 license.