Verified and Tested 12/14/15
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.
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.
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]";
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
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:
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
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.”
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
In the Administrator page, fill out the forms with your personal information. Once done click “Continue.”
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
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.