How to install OctoberCMS on Ubuntu

How to install OctoberCMS on Ubuntu

OctoberCMS is an open source Content Management System allows users to create their own blogs or websites without having any prior knowledge about coding from scratch. October CMS allows the users to create site in graphical way similar to other CMS software’ s like Word press and etc. This tutorial explains the installation procedure of OctoberCMS on Ubuntu.

Installation Procedure

Before starting the installation procedure of OctoberCMS, first install the LAMP packages, where every CMS software will require either LAMP or LEMP environment. To install the LAMP server, execute the following command.

root@linuxhelp1:~# apt-get install lamp-server^ -y
Reading package lists... Done
Building dependency tree      
Reading state information... Done
Note, selecting ' libhttp-message-perl'  for task ' lamp-server' 
Note, selecting ' libencode-locale-perl'  for task ' lamp-server' 
Note, selecting ' php7.0-cli'  for task ' lamp-server' 
Note, selecting ' mysql-client-5.7'  for task ' lamp-server' 
Note, selecting ' libapache2-mod-php'  for task ' lamp-server' 
Note, selecting ' rename'  for task ' lamp-server' 
Note, selecting ' mysql-server-5.7'  for task ' lamp-server' 
Note, selecting ' php-common'  for task ' lamp-server' 
Note, selecting ' libaprutil1'  for task ' lamp-server' 
Note, selecting ' mysql-server'  for task ' lamp-server' 
Note, selecting ' php7.0-opcache'  for task ' lamp-server' 
.
.
.
Creating config file /etc/php/7.0/mods-available/pdo_mysql.ini with new version
Setting up php-mysql (1:7.0+35ubuntu6) ...
Processing triggers for libc-bin (2.23-0ubuntu3) ...
Processing triggers for ureadahead (0.100.0-19) ...
Processing triggers for systemd (229-4ubuntu4) ...
Processing triggers for ufw (0.35-0ubuntu2) ...
Processing triggers for libapache2-mod-php7.0 (7.0.15-0ubuntu0.16.04.4) ...

The LAMP environment is installed successfully. Now install the following PHP Extensions required by OctoberCMS.

root@linuxhelp1:~# apt-get install php7.0-mysql php7.0-curl php7.0-json php7.0-cgi php7.0 libapache2-mod-php7.0 php7.0-mcrypt php7.0-gd -y
Reading package lists... Done
Building dependency tree      
Reading state information... Done
libapache2-mod-php7.0 is already the newest version (7.0.15-0ubuntu0.16.04.4).
php7.0-json is already the newest version (7.0.15-0ubuntu0.16.04.4).
php7.0-mysql is already the newest version (7.0.15-0ubuntu0.16.04.4).
The following additional packages will be installed:
  libmcrypt4
Suggested packages:
  libmcrypt-dev mcrypt php-pear
The following NEW packages will be installed:
  libmcrypt4 php7.0 php7.0-cgi php7.0-curl php7.0-gd php7.0-mcrypt
0 upgraded, 6 newly installed, 0 to remove and 476 not upgraded.
Need to get 1,380 kB of archives.
After this operation, 9,229 kB of additional disk space will be used.
Get:1 http://in.archive.ubuntu.com/ubuntu xenial/universe amd64 libmcrypt4 amd64 2.5.8-3.3 [63.0 kB]
.
.
.
Creating config file /etc/php/7.0/mods-available/gd.ini with new version
Setting up php7.0-mcrypt (7.0.15-0ubuntu0.16.04.4) ...
Creating config file /etc/php/7.0/mods-available/mcrypt.ini with new version
Processing triggers for libc-bin (2.23-0ubuntu3) ...
Processing triggers for libapache2-mod-php7.0 (7.0.15-0ubuntu0.16.04.4) ...

To download the package for OctoberCMS execute the following command and a zip file will be downloaded in the target system.

root@linuxhelp1:~# wget http://octobercms.com/download -O octobercms.zip
--2017-04-12 14:25:33--  http://octobercms.com/download
Resolving octobercms.com (octobercms.com)... 104.24.113.12, 104.24.112.12, 2400:cb00:2048:1::6818:700c, ...
Connecting to octobercms.com (octobercms.com)|104.24.113.12|:80... connected.
HTTP request sent, awaiting response... 302 Found
Location: https://github.com/octobercms/install/archive/master.zip [following]
--2017-04-12 14:25:34--  https://github.com/octobercms/install/archive/master.zip
.
.
.
Resolving codeload.github.com (codeload.github.com)... 192.30.253.120, 192.30.253.121
Connecting to codeload.github.com (codeload.github.com)|192.30.253.120|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: unspecified [application/zip]
Saving to: ‘ octobercms.zip’ 
octobercms.zip                                  [                   < =>                                                                     ] 135.43K  16.0KB/s    in 8.5s   
2017-04-12 14:25:46 (16.0 KB/s) - ‘ octobercms.zip’  saved [138684]

Next to extract the package directly into document root of apache web server, create a directory called “ octobercms” under document root of apache and place the content there.

root@linuxhelp1:~# unzip octobercms.zip -d /var/www/html/octobercms/
Archive:  octobercms.zip
9dfe4aebce81a93c3c2d0c983eec705a0e6d28ee
   creating: /var/www/html/octobercms/install-master/
 extracting: /var/www/html/octobercms/install-master/.gitignore 
  inflating: /var/www/html/octobercms/install-master/README.md 
  inflating: /var/www/html/octobercms/install-master/install.php 
   creating: /var/www/html/octobercms/install-master/install_files/
   creating: /var/www/html/octobercms/install-master/install_files/css/
  inflating: /var/www/html/octobercms/install-master/install_files/css/animations.css 
  inflating: /var/www/html/octobercms/install-master/install_files/css/controls.css 
  inflating: /var/www/html/octobercms/install-master/install_files/css/fonts.css
.
.
.
master/install_files/php/Installer.php 
  inflating: /var/www/html/octobercms/install-master/install_files/php/InstallerException.php 
  inflating: /var/www/html/octobercms/install-master/install_files/php/InstallerRewrite.php 
  inflating: /var/www/html/octobercms/install-master/install_files/php/boot.php

The package has been extracted in the directory. Set the ownership and file permission for octoberCMS directory as shown like below.

root@linuxhelp1:~# chown -R www-data:www-data /var/www/html/octobercms/
root@linuxhelp1:~# chmod -R 755 /var/www/html/octobercms/

Now log in to MySQL Database to create database and database user for octoberCMS.

root@linuxhelp1:~# mysql -u root -p
Enter password:
Welcome to the MySQL monitor.  Commands end with   or g.
Your MySQL connection id is 5
Server version: 5.7.17-0ubuntu0.16.04.2 (Ubuntu)
Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type ' help '  or ' h'  for help. Type ' c'  to clear the current input statement.
mysql>  create database octobercmsdb character set utf8 
Query OK, 1 row affected (0.00 sec)
mysql>  GRANT ALL PRIVILEGES ON octobercmsdb.* TO ' octobercms' @' localhost'  IDENTIFIED BY ' 123'  
Query OK, 0 rows affected, 1 warning (0.03 sec)
mysql>  flush privileges 
Query OK, 0 rows affected (0.00 sec)
mysql>  quit
Bye

Enable the apache rewrite module by running the following command.

root@linuxhelp1:~# a2enmod rewrite
Enabling module rewrite.
To activate the new configuration, you need to run:
  service apache2 restart

To create virtual host configuration file run the following command and save the configuration file.

root@linuxhelp1:~# touch /etc/apache2/sites-available/octobercms.conf
root@linuxhelp1:~# ln -s /etc/apache2/sites-available/octobercms.conf /etc/apache2/sites-enabled/octobercms.conf
root@linuxhelp1:~# vim /etc/apache2/sites-available/octobercms.conf

Restart apache service by executing the following command.

root@linuxhelp1:~# systemctl restart apache2

Now open the browser and goto the link http://192.168.7.234/octobercms/install-master/install.php to open the octoberCMS site.

Select the ' Agree and Continue' button to continue with the installation procedure.

Now enter the database details and select the ' administrator' button to save the changes made in the database.

Create admin account with all the required credentials.

Select “ Start from a theme” to install octoberCMS site with a theme

Choose any theme that you want to install to create the website with. For that select any type of theme and click install button.

The installation is in progress and it may take some time.