Install October CMS on an Ubuntu VPS with Nginx and MariaDB

Install October CMS on an Ubuntu VPS with Nginx and MariaDB

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.

We are proud to be an Official OctoberCMS Partner – 


Update the system and install necessary packages.

[email protected]:~# apt-get -y update && apt-get -y upgrade
[email protected]:~# apt-get install python-software-properties curl git

Install MariaDB and create a database.

[email protected]:~#  apt-key adv --recv-keys --keyserver hkp:// 0xcbcb082a1bb943db
[email protected]:~# add-apt-repository 'deb trusty main'
[email protected]:~# apt-get -y update
[email protected]:~# echo -e "Package: *\nPin: origin\nPin-Priority: 1000" | tee /etc/apt/preferences.d/mariadb
[email protected]:~# apt-get install mariadb-server
[email protected]:~# 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

[email protected]:~# curl -sS | php
[email protected]:~# mv composer.phar /usr/local/bin/composer

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

[email protected]:~# mkdir -p /var/www/{public_html,logs}
[email protected]:~# cd /var/www/
[email protected]:~# composer create-project october/october public_html dev-master


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

'url' => ''

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


Create a new Nginx server block with the following content

[email protected]:~# cat <<'EOF' > /etc/nginx/sites-available/
server {
    listen 80;
    root /var/www/;
    access_log /var/www/;
    error_log /var/www/;
    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;


Symlink it and restart the server

[email protected]:~# ln -s /etc/nginx/sites-available/ /etc/nginx/sites-enabled/
[email protected]:~# /etc/init.d/nginx restart

Set the correct permissions

[email protected]:~# chown -R www-data: /var/www/

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.

Install VSFTPD on an Ubuntu 16.04 VPS
Install Nikto web scanner on an Ubuntu VPS
Install PmWiki on an Ubuntu 14.04 VPS with Nginx
  • Xyzer


    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.
    ([email protected]:~# cd /var/www/ instead of [email protected]:~# cd /var/www/
    – Users might also need Mcrypt php extension to be installed correctly: