Install Croogo on an Ubuntu VPS with Nginx and MariaDB

In this post, we will cover how to install Croogo on an Ubuntu VPS with the latest versions of Nginx and MariaDB. Croogo is a free, open-source, content management system released under the MIT license, written in PHP and it’s built upon the CakePHP MVC 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.

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

Install MariaDB 10 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 croogo;
MariaDB [(none)]>; GRANT ALL PRIVILEGES ON croogo.* TO 'croogo'@'localhost' IDENTIFIED BY 'croogoPassword'
MariaDB [(none)]>; flush privileges;
MariaDB [(none)]>; \q;

Install PHP and Nginx

The latest version of Nginx 1.6.2 is not available via the default Ubuntu repositories, so we will add the “nginx/stable” PPA, update the system and install the nginx package.

[email protected]:~#add-apt-repository ppa:nginx/stable
[email protected]:~# apt-get update
[email protected]:~# apt-get install nginx php5-fpm php-cli php5-mysql php5-mcrypt

Install Composer

In case you never heard of composer, it is a dependency manager for PHP with which you can install packages. In other words, composer will pull all the required libraries you need for your project.

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

Create a root directory for your web site and install croogo

[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 croogo/app public_html

PHP

CakePHP requires PHP mcrypt extension to be installed, so we need to enable the previously installed mcrypt extension by running the following command:

[email protected]:~# php5enmod mcrypt

and restart php fpm for the changes to take effect.

[email protected]:~# service php5-fpm restart

Nginx

Create a new Nginx server block with the following content:

[email protected]:~# cat <<'EOF' >; /etc/nginx/conf.d/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 ~* \.(?:ico|css|js|gif|jpe?g|png|ttf|woff)$ {
        access_log off;
        expires 30d;
        add_header Pragma public;
        add_header Cache-Control "public, mustrevalidate, proxy-revalidate";
    }
 
    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

Test the Nginx configuration and restart the server by  running the following commands:

[email protected]:~# nginx -t
[email protected]:~# /etc/init.d/nginx restart

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 and follow the installation wizard.

For more information, please check out the official Croogo website.

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.