Verified and Tested 12/14/15

Introduction

This how-to will take you through installing October CMS on Ubuntu 14.04 LTS. October CMS is a content management system that is free and open source. It is a relatively new content management system and is built on the Laravel web application framework.

Prerequisites

To install October CMS following this guide, you’ll need an Ubuntu 14.04 server running LAMP. Please see our how-to guide for installing LAMP. Atlantic.Net offers reliable VPS Cloud servers  and One-Click October CMS installation.

Installing October CMS on Ubuntu 14.04

Installing October CMS is very simple if you follow these steps. Before we begin it is important to check that your system is synchronized to your package sources by running the following command:

sudo apt-get update

We also need to install wget and unzip with the following command:

sudo apt-get install unzip wget

Setting up the MySQL database in Ubuntu 14.04

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

sudo mysql -u root -p

When prompted, enter your MySQL root password that you set up when installing MySQL.

In MySQL enter the following commands:

create database octobercms character set utf8 collate utf8_bin;

Set a secure password for the user octobercmsuser where it says [insert-password-here].

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

Get the October CMS Installer on Ubuntu 14.04

Now that the database is created, we can download the October CMS installer with the following command:

sudo wget http://octobercms.com/download

This will download a file called download, to make this usable we need to rename it to download.zip  with the following command:

sudo mv download download.zip

Now that it is a file format that Ubuntu understands, unzip it with the following command:

sudo unzip download.zip

Now we are going to move the unzipped files to your web directory with the following command:

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

 

Add the PHP Extensions and Libraries That October CMS Needs on Ubuntu 14.04

October CMS requires the following php extensions and libraries installed: PDO, cURL, OpenSLL, MCrypt, Mbstring, ZipArchive and GD. Most of these are installed when installing PHP on Ubuntu via APT. However, you can ensure you have all of them installed with the following command (it will only install the packages that aren’t already installed):

sudo apt-get install php5-curl mcrypt php5-mcrypt php5-gd

After installing mcrypt we need to enable it with the following command:

sudo php5enmod mcrypt

Restart Apache so that all changes take place with the following command:

sudo service apache2 restart

 Set The File Permissions for October CMS

We need to make sure October CMS has permission to write to the web directories and files. Do so with the following commands:

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

 

Finish The Installation Through The October CMS Web Installation.

Now, we can go to the October CMS web installation. In your browser go to http://yourhostname-or-ipaddress/install.php

If you are unsure what your IP address is, run the following:

ifconfig
An example of ifconfig showing the IP address of 172.20.6.154

An example of ifconfig showing the IP address of 172.20.6.154

In our example, we would put http://172.20.6.154/install.php in the address bar and get the following page.

 

An example of the October CMS system check

An example of the October CMS system check

Check that you have green checks next to each item. If all is green scroll down to the license agreement. Once you have read the details, go ahead and click “Agree & Continue.”

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

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

Now we need to enter the database information that we set up in the first step. Once you’ve entered the database information, click the “Administrator >” button in the lower right.

Enter the database information that was set up earlier

Enter the database information that was set up earlier

In the Administrator page, fill out the forms with your personal information. Once done click “Continue.”

Enter your information that October CMS requires

Enter your information that October CMS requires

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

Choose to Start from Scratch, Start from a theme or Use a project ID

Choose to Start from Scratch, Start from a theme or Use a project ID

Congratulations! You have just installed October CMS on Ubuntu 14.04. Thank you for following this guide, and we hope you enjoyed it. Please come back for more updates, or read the related guide below.