Install October CMS on Ubuntu, 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 Ubuntu, 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. Installing October CMS on Ubuntu, is fairly easy task, and it should not take more then 10 minutes.

We are proud to be an Official OctoberCMS Partner 

1. 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

2. Install MariaDB and create a database.

root@vps:~#  apt-key adv --recv-keys --keyserver hkp:// 0xcbcb082a1bb943db
root@vps:~# add-apt-repository 'deb trusty main'
root@vps:~# apt-get -y update
root@vps:~# echo -e "Package: *\nPin: origin\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;

3. Install PHP and Nginx

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

4. Install Composer

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

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

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

6. Configuration

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

7. Nginx Configuration

Create a new Nginx server block with the following content

root@vps:~# 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

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

8. Set the correct permissions

root@vps:~# 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
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 Optimized CMS Hosting Stacks, in which case you can simply ask our expert Linux admins to Install October CMS on Ubuntu, for you. They are available 24×7 and will take care of your request immediately. You can also check our guide on How to install October CMS on CentOS 7.

PS. If you liked this post, on how to install October CMS on Ubuntu,  please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

1 thought on “Install October CMS on Ubuntu, with Nginx and MariaDB”

  1. 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/ instead of root@vps:~# cd /var/www/
    – Users might also need Mcrypt php extension to be installed correctly:


Leave a Comment

To prove you are human please solve the following *