Install October CMS on an Ubuntu VPS with Nginx and MariaDB


logo

In this post, we will cover how to install October CMS on an Ubuntu VPS with Nginx and MariaDB. October is a free, open-source, self-hosted CMS platform , written in PHP and it’s built upon the Laravel framework. This should work on other Linux VPS systems as well but was tested and written for Ubuntu 14.04.

 

Update the system and install necessary packages.

root@vps:~# apt-get -y update && apt-get -y upgrade
root@vps:~# apt-get install python-software-properties curl git

Install MariaDB and create a database.

root@vps:~#  apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xcbcb082a1bb943db
root@vps:~# add-apt-repository 'deb http://ftp.osuosl.org/pub/mariadb/repo/10.0/ubuntu trusty main'
root@vps:~# apt-get -y update
root@vps:~# echo -e "Package: *\nPin: origin ftp.osuosl.org\nPin-Priority: 1000" | tee /etc/apt/preferences.d/mariadb
root@vps:~# apt-get install mariadb-server
root@vps:~# mysql -uroot -p
MariaDB [(none)]> create database octobercms;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON octobercms.* TO 'octobercms'@'localhost' IDENTIFIED BY 'octobercmsPassword'
MariaDB [(none)]> flush privileges;
MariaDB [(none)]> \q;

Install PHP and Nginx

apt-get install nginx php5-fpm php-cli php5-mysql php5-mcrypt php5-curl php5-sqlite

Install Composer

root@vps:~# curl -sS https://getcomposer.org/installer | php
root@vps:~# mv composer.phar /usr/local/bin/composer

Create a root directory for your web site and download the application source code

root@vps:~# mkdir -p /var/www/yourwebsite.com/{public_html,logs}
root@vps:~# cd /var/www/yourwebsite.com/public_html
root@vps:~# composer create-project october/october public_html dev-master

Configuration

Open the file app/config/app.php and change:

'url' => 'http://yourwebsite.com'

Open the file app/config/cms.php and change:

'activeTheme' => 'demo',
'backendUri' => '/admin'

Open the file app/config/database.php and and set the database connection parameters.

Run the following artisan commands”

php artisan key:generate
php artisan october:up

Nginx.

Create a new Nginx server block with the following content

root@vps:~# cat <<'EOF' > /etc/nginx/sites-available/yourwebsite.com
server {
    server_name yourwebsite.com;
    listen 80;
    root /var/www/yourwebsite.com/public_html;
    access_log /var/www/yourwebsite.com/logs/access.log;
    error_log /var/www/yourwebsite.com/logs/error.log;
    index index.php;
 
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
 
    location ~ \.php$ {
        fastcgi_index index.php;
        fastcgi_split_path_info ^(.+\.php)(.*)$;
        fastcgi_keep_conn on;
        include /etc/nginx/fastcgi_params;
        fastcgi_pass unix:/var/run/php5-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
 
    location ~ /\.ht {
        deny all;
    }

}
EOF

Symlink it and restart the server

root@vps:~# ln -s /etc/nginx/sites-available/yourwebsite.com /etc/nginx/sites-enabled/yourwebsite.com
root@vps:~# /etc/init.d/nginx restart

Set the correct permissions

root@vps:~# chown -R www-data: /var/www/yourwebsite.com/public_html/

That’s it. Now open your browser, type the address of your website and use the default username admin and password admin.

Please check the official October website for more details.

Of course you don’t have to do any of this if you use one of our Linux VPS Hosting services, in which case you can simply ask our expert Linux admins to set this up for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

Tutorials
How to install and integrate DKIM with OpenDKIM and Postfix on a CentOS 6 VPS
Tutorials
How to install Kanboard on a CentOS 7 VPS
Tutorials
How to install Contao on an Ubuntu 14.04 VPS
  • Xyzer

    XyzerXyzer

    Author Reply

    Great post on how to install October!

    A few notes:
    – During the install, also install php5-gd.
    – GRANT ALL PRIVILEGES ON octobercms.* TO ‘octobercms’@’localhost’ IDENTIFIED BY ‘octobercmsPassword’ misses a semicolon (;) at the end.
    – When downloading the application source, the user should be one folder above public_html.
    (root@vps:~# cd /var/www/yourwebsite.com instead of root@vps:~# cd /var/www/yourwebsite.com/public_html)
    – Users might also need Mcrypt php extension to be installed correctly:
    http://www.kvcodes.com/2014/07/laravel-requires-mcrypt-php-extension/