Verified and Tested 12/31/15


We will be installing October CMS on CentOS 7.2 in this how-to guide. October CMS is a content management system that uses the Laravel web application framework. It is a free and open source and has been widely adopted by the developer community.


This guide requires a CentOS 7.2 server running LAMP. You can follow our guide on installing LAMP if you have not already done so.

Need a CentOS server? Try our CentOS SSD Cloud Servers.

Installing October CMS on CentOS 7.2

Before installing October CMS, it is important to check that your system updated by running the following command:

yum update

If you have a minimum installation, You will need to install wget and unzip with the following command:

sudo yum install unzip wget

Setting up the MySQL Database in CentOS 7.2

October CMS requires a database. To create a new MySQL database run the following commands:

sudo mysql -u root -p

After entering the above command, you will be prompted to enter your MySQL root password. Typically you would have set that password when installing MySQL

Enter the following MySQL commands:

create database octobercms character set utf8 collate utf8_bin;

Set a secure password for the database user octobercmsuser by replacing [insert-password-here] with a password of your choice.

grant all privileges on octobercms.* to [email protected] identified by "[insert-password-here]";
flush privileges;

Download the October CMS Installer on CentOS 7.2

After creating the October CMS database, we can download the October CMS installer with the following command:

sudo wget

The above command will download a file called download, and we need to rename it to  with the following command:

sudo mv download

Now CentOS has a file format that it understands, unzip it with the following command:

sudo unzip

We can now move the unzipped files to the apache web directory with the following command:

sudo cp -r ~/install-master/* /var/www/html


Adding the PHP Extensions and Libraries that October CMS Requires on CentOS 7.2

October CMS requires the following PHP extensions and libraries installed: PDO, cURL, OpenSLL, MCrypt, Mbstring, ZipArchive, and GD. Most of these get installed when installing PHP on CentOS via yum. We can install the rest of the packages that need installing with the following commands:

sudo yum install epel-release
sudo yum install php-mcrypt php-mbstring php-gd

For the PHP extensions and libraries to work, we need to restart Apache with the following command:

sudo systemctl restart httpd.service

 Setting File Permissions for October CMS

October CMS requires permission to write to the web directories and files. Run the following commands to give the Apache user writing privileges:

sudo chown -R apache:apache /var/www/html/
sudo chmod -R 755 /var/www/html/


Using The October CMS Web Installation to Finish the Installation

To finish the installation,  go to the October CMS web installation page by opening your browser and going to http://yourhostname-or-ipaddress/install.php

Note: If you do not know your IP address, you can run the following command:

ip addr show eth0
An example of running the command: ip addr show eth0 and getting for the IP address.

An example of  ip addr show eth0 getting as the IP address.

In our example, we would put into our browser’s address bar.

An example of the October CMS system check

This is an October CMS system check page with all green check marks

Verify that you have green check marks next to each item. If all is green, you can scroll down to accept the license agreement and click “Agree & Continue.”

Once you have read the details, go ahead and click "Agree & Continue."

After reading the details, click “Agree & Continue.”

On the next page, we are going to enter the database information that was set up earlier. Click the “Administrator >” button in the lower right, after entering your database information.


Enter in the database information that you set up earlier

Enter in the database information that you set up earlier

On the Administrator page, fill out the forms using your personal information that October CMS requires. Once done click “Continue.”

Enter your personal information that October CMS requires

Enter your personal information that October CMS requires

Your October CMS installation is now complete, it now gives you a few options on how you want your site to look like.

You can choose "Start from Scratch", "Start from a theme" or "Use a project ID"

You can choose “Start from Scratch”, “Start from a theme” or “Use a project ID.”

Congratulations! You have just installed October CMS on a CentOS 7.2 server. We hope you have enjoyed this guide, please check back here for more updates, or read the related guide below.  Atlantic.Net also offers popular one-click application installations like October Cloud Hosting, among many others.