- \n
- Ubuntu 16.04<\/li>\n
- Root privileges<\/li>\n<\/ul>\n
What we will do:<\/h2>\n
- \n
- Install Nginx<\/li>\n
- Install and Configure PHP-FPM<\/li>\n
- Install PHP Composer<\/li>\n
- Download and Install Grav CMS<\/li>\n
- Configure Nginx Virtual Host for Grav<\/li>\n
- Testing<\/li>\n<\/ol>\n
Step 1 – Install Nginx Web Server<\/h2>\n
In this first step, we will install the Nginx web server from the Ubuntu repository. Before we do that, we need update all packages and repository using the following apt commands.<\/p>\n
sudo apt update
sudo apt upgrade<\/p>\nNow install the Nginx web server.<\/p>\n
sudo apt install nginx -y<\/p>\n
After the installation is complete, start the service and enable it to launch at system boot, something which you can do using the following systemctl commands.<\/p>\n
systemctl start nginx
systemctl enable nginx<\/p>\nThe Nginx web server has been installed on Ubuntu 16.04, and it’s running on the default HTTP port 80. Check it using the netstat command in the following way.<\/p>\n
netstat -plntu<\/p>\n
And you will get the result as shown below.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/01\/how-to-install-grav-cms-with-nginx-on-ubuntu-16-04.png\" "\\"\\"")
<\/a><\/p>\nStep 2 – Install and Configure PHP-FPM<\/h2>\n
Now we will install and configure PHP-FPM for our Grav installation. Install PHP and PHP-FPM packages (including all required extensions) using the following command.<\/p>\n
sudo apt install -y php7.0 php7.0-fpm php7.0-cli php7.0-gd php7.0-mbstring php-pear php7.0-curl php7.0-dev php7.0-opcache php7.0-xml php7.0-zip<\/p>\n
Now we need to configure PHP-FPM.<\/p>\n
– Install additional extensions<\/strong><\/p>\n
This is optional, but it’s best for Grav performance. We will install some additional extensions manually from the PHP extensions repository using the PECL command.<\/p>\n
Install the ‘apcu’ extension (for increased cache performance) using the ‘pecl’ command below.<\/p>\n
sudo pecl install apcu<\/p>\n
Now create a new extension configuration ‘apcu.ini’ in the ‘\/etc\/php\/7.0\/mods-available\/’ directory.<\/p>\n
sudo vim \/etc\/php\/7.0\/mods-available\/apcu.ini<\/p>\n
Paste the following configuration there.<\/p>\n
extension=apcu.so<\/pre>\n
Save and exit.<\/p>\n
Next, activate the extension using the commands below.<\/p>\n
sudo ln -s \/etc\/php\/7.0\/mods-available\/apcu.ini \/etc\/php\/7.0\/fpm\/conf.d\/20-apcu.ini
sudo ln -s \/etc\/php\/7.0\/mods-available\/apcu.ini \/etc\/php\/7.0\/cli\/conf.d\/20-apcu.ini<\/p>\n![\"Enable](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/01\/how-to-install-grav-cms-with-nginx-on-ubuntu-16-04-1.png\" "\\"\\"")
<\/a><\/p>\nNow, we will install the ‘YAML’ extension to further improve Grav performance. But before installing the extension, we need to install some packages using the following apt command.<\/p>\n
sudo apt install libyaml-dev unzip -y<\/p>\n
Next, install the yaml extensions using the pecl command.<\/p>\n
sudo pecl install yaml-2.0.0<\/p>\n
After the installation is complete, create a new ‘yaml.ini’ configuration file.<\/p>\n
sudo vim \/etc\/php\/7.0\/mods-available\/yaml.ini<\/p>\n
Paste the following configuration there.<\/p>\n
extension=yaml.so<\/pre>\n
Save and exit.<\/p>\n
Now activate the YAML extension.<\/p>\n
sudo ln -s \/etc\/php\/7.0\/mods-available\/yaml.ini \/etc\/php\/7.0\/fpm\/conf.d\/20-yaml.ini
sudo ln -s \/etc\/php\/7.0\/mods-available\/yaml.ini \/etc\/php\/7.0\/cli\/conf.d\/20-yaml.ini<\/p>\n![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/01\/how-to-install-grav-cms-with-nginx-on-ubuntu-16-04-2.png\" "\\"\\"")
<\/a><\/p>\nNew additional PHP extensions for Grav have been added.<\/p>\n
– Configure PHP-FPM Pool for Grav<\/strong><\/p>\n
Before creating a new PHP-FPM pool configuration, we need to add a new user named ‘grav’ to the system, something which you can do using the useradd command.<\/p>\n
useradd -m -s \/bin\/bash grav
passwd grav<\/p>\nNow go to the ‘\/etc\/php\/7.0\/fpm\/pool.d’ directory and backup the default ‘www.conf’ configuration.<\/p>\n
cd \/etc\/php\/7.0\/fpm\/pool.d\/
mv www.conf www.conf.bak<\/p>\nNext, create new PHP-FPM pool configuration – ‘grav.conf’ – for Grav.<\/p>\n
vim grav.conf<\/p>\n
Paste the following configuration there.<\/p>\n
[grav]
user = grav
listen = \/run\/php\/php7.0-fpm.sock<\/p>
listen.owner = www-data
pm = dynamic
chdir = \/<\/p><\/pre>\n
Save and exit.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/01\/how-to-install-grav-cms-with-nginx-on-ubuntu-16-04-3.png\" "\\"\\"")
<\/a><\/p>\nRestart the PHP-FPM service and enable it to launch at system boot.<\/p>\n
systemctl restart php7.0-fpm
systemctl enable php7.0-fpm<\/p>\nPHP-FPM is now running under the ‘php7.0-fpm.sock’ file – check it using the netstat command in the following way.<\/p>\n
netstat -pl | grep php<\/p>\n
And you should get the result as shown below.<\/p>\n
![\"Start](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/01\/how-to-install-grav-cms-with-nginx-on-ubuntu-16-04-4.png\" "\\"\\"")
<\/a><\/p>\nNote:<\/strong><\/p>\n
If you want to check the apcu and yaml extensions, you can use the following php commands.<\/p>\n
sudo php -m | grep apcu
sudo php -m | grep yaml<\/p>\n![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/01\/how-to-install-grav-cms-with-nginx-on-ubuntu-16-04-5.png\" "\\"\\"")
<\/a><\/p>\nInstallation and configuration for PHP-FPM has been completed.<\/p>\n
Step 3 – Install PHP Composer<\/h2>\n
The composer is an application-level package manager for PHP. It’s used for managing PHP dependencies.<\/p>\n
Install the PHP Composer using the following command.<\/p>\n
curl -sS https:\/\/getcomposer.org\/installer | php
sudo mv composer.phar \/usr\/local\/bin\/composer<\/p>\nAfter the installation is complete, try to run the composer command in the following way.<\/p>\n
composer –version<\/p>\n
The PHP Composer has been installed.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/01\/how-to-install-grav-cms-with-nginx-on-ubuntu-16-04-6.png\" "\\"\\"")
<\/a><\/p>\nStep 4 – Download and Install Grav<\/h2>\n
We will install and run the tool as ‘grav’ user. The user was created in one of the previous steps.<\/p>\n
First, login as ‘grav’ user.<\/p>\n
su – grav<\/p>\n
Now, create a new ‘www’ directory.<\/p>\n
mkdir -p ~\/www
cd ~\/www<\/p>\nDownload the latest grav version using wget and add a ‘.zip’ extension to the file name.<\/p>\n
wget https:\/\/getgrav.org\/download\/core\/grav\/latest
mv latest latest.zip<\/p>\nExtract ‘latest.zip’ file and rename the ‘grav’ directory to ‘html’.<\/p>\n
unzip latest.zip
mv grav\/ html\/<\/p>\nNow back to root priveliges and change the group owner to ‘www-data’.<\/p>\n
exit
cd \/home\/grav\/www
sudo chown -R grav:www-data html\/<\/p>\nGrav is now downloaded and installed by the ‘grav’ user in the ‘\/home\/grav\/www\/html’ directory.<\/p>\n
Step 5 – Configure Grav virtual host<\/h2>\n
In this step, we will configure the Nginx virtual host for Grav. We will create a new virtual host file named ‘grav’ inside the ‘sites-available’ directory,\u00a0 and then activate the Grav virtual host.<\/p>\n
Goto the ‘\/etc\/nginx’ configuration directory and create a new file ‘grav’ using the vim editor<\/a>.<\/p>\n
cd \/etc\/nginx
vim sites-available\/grav<\/p>\nPaste the following Grav Nginx virtual host configuration there.<\/p>\n
server {\u00a0\u00a0\u00a0 ## Web root and Domain Name
\u00a0\u00a0\u00a0 ## Begin - Index
\u00a0\u00a0\u00a0 ## Begin - PHP-FPM Configuration
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 fastcgi_split_path_info ^(.+\\.php)(\/.+)$;
\u00a0\u00a0\u00a0 ## Begin - Security
Save and exit.<\/p>\n
Next, activate the virtual host and test the nginx configuration.<\/p>\n
ln -s \/etc\/nginx\/sites-available\/grav \/etc\/nginx\/sites-enabled\/
nginx -t<\/p>\nNote: <\/strong>Make sure you get no Nginx error after testing the configuration.<\/p>\n
Now restart the Nginx and PHP-FPM services.<\/p>\n
systemctl restart nginx
systemctl restart php7.0-fpm<\/p>\n
![\"Install](\"https:\/\/www.howtoforge.com\/images\/how_to_install_and_configure_grav_cms_on_ubuntu_1604\/big\/1.png\" "\\"\\"")
<\/a><\/p>\n