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.

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

2. Install MariaDB and create a database.

[email protected]:~#  apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xcbcb082a1bb943db
[email protected]:~# add-apt-repository 'deb http://ftp.osuosl.org/pub/mariadb/repo/10.0/ubuntu trusty main'
[email protected]:~# apt-get -y update
[email protected]:~# echo -e "Package: *\nPin: origin ftp.osuosl.org\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;

3. Install PHP and Nginx

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

4. Install Composer

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

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

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

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

7. Nginx Configuration

Create a new Nginx server block with the following content

[email protected]:~# 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

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

8. Set the correct permissions

[email protected]:~# 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
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.

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.

Tutorials
Install Gogs on an Ubuntu 14.04 VPS
Tutorials
Install InvoicePlane on a CentOS VPS
Tutorials
Install Ghost on CentOS 7
  • 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.
    ([email protected]:~# cd /var/www/yourwebsite.com instead of [email protected]:~# 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/