Crucial Web Hosting is another of the new bread of modern web hosting platforms that focuses on both speed and support. The use of SSD drives and Litespeed web servers with the latest Intel XEON processors ensures that Grav performs fantastically. Crucial also now provides PHP all the way up to the latest PHP 7.0 releases.
In this guide, we will cover the essentials for configuring the Tier-1 Split-Shared hosting package to work optimally with Grav.
Crucial Web Hosting has two primary options when it comes to hosting: Spit-Shared and Split-Dedicated hosting. According to Crucial, these cloud-based options are superior to traditional hosting setups as they provide better isolation and performance.
Split-Shared hosting ranges from $10/month to $100/month depending on memory and SSD space. Split Dedicated ranges from $150/month to $650/month depending on number of cores, memory, SSD space and bandwidth. We'll just be using the baseline $10/month option that comes with 256MB of memory and 10GB of SSD space.
First, you will have to open the Toggle SSH Access option in the Security section of cPanel. On this SSH Access page, you should click the Enable SSH Access button.
Then from the Security Section again, click the Manage SSH Keys option.
There are two options at this point. Generate a New Key, or Import Key. It's simpler to create your public/private key pair locally on your computer and then just import the DSA Public Key.
Windows users will first need to install Cygwin to provide many useful GNU and open source tools that are available on Mac and Linux platforms. When prompted to choose packages, ensure you check the SSH option. After installation, launch the
Fire up a terminal window and type:
ssh-keygen -t dsa
This key generation script will prompt you to fill in some values, or you can just hit
[return] to accept the default values. This will create an
id_dsa (private key), and an
id_dsa.pub (public key) in a folder called
.ssh/ in your home directory. It is important to ensure you NEVER give out your private key, nor upload it anywhere, only your public key.
Once generate you can paste the contents of your
id_dsa.pub public key into the
Public Key field in the Import SSH key section of the SSH Access page:
After uploading, you should see the key listed at the Public Keys section of the Manage SSH Keys page. You then need to click Manage to ensure the key is authorized:
This means you are ready to test ssh'ing to your server.
Obviously, you will need to put in your Crucial-provided username for
crucial_username, and the crucial-provided servername for
Currently Crucial Web Hosting defaults to PHP 5.3, which is not up to the minimum requirements for Grav. Luckily Crucial supports PHP all the way up to the latest PHP 7.0 so we change the PHP version to something more current.
To do this, we have to add a special handler call in the
.htaccess file in the web root. So create the
~/www/.htaccess file and put the following:
AddHandler application/x-httpd-php70 .php
Save the file. To test that you have the correct version of PHP, you can create a temporary file:
~/www/info.php and put this in the contents:
Save the file and point your browser to this info.php file on your site, and you should be greeted with PHP information reflecting the version you selected earlier:
If you are installing Grav at the root of your hosting account, you will need to add the AddHandler method to the top of the
.htaccess file that is provided with Grav
You can choose another version of php to run Grav under using such as PHP 5.6 with
x-httpd-php56 for example
At the time of this writing, Crucial's default PHP version is 5.3. Because Grav requires PHP 5.5+, we need to ensure that Grav is using a newer version of PHP on the command line (CLI). To accomplish this, you should use SSH to access your server and create a new symbolic link to a newer PHP version in your user's
ln -s /usr/local/bin/php-70 ~/bin/php
Next, edit your
.bash_profile file and add move the
$HOME/bin reference in front of the regular
# .bash_profile # Get the aliases and functions if [ -f ~/.bashrc ]; then . ~/.bashrc fi # User specific environment and startup programs PATH=$HOME/bin:$PATH export PATH
You will need source the profile:
$ source ~/.bash_profile or re-login to your terminal for you path change to take effect, but after doing so you should be able to type
php -v and see:
php -v PHP 7.0.1 (cli) (built: Dec 28 2015 17:55:36) ( NTS ) Copyright (c) 1997-2015 The PHP Group Zend Engine v3.0.0, Copyright (c) 1998-2015 Zend Technologies with Zend OPcache v7.0.6-dev, Copyright (c) 1999-2015, by Zend Technologies
Using your new found SSH capabilities, let's SSH to your Crucial server (if you are not already there) and download the latest version of Grav, unzip it and test it out!
We will extract Grav into a
/grav subfolder, but you could unzip directly into the root of your
~/www/ folder to ensure Grav is accessible directly.
cd ~/www wget --no-check-certificate https://getgrav.org/download/core/grav/latest unzip grav-v1.7.8.zip
You should now be able to point your browser to
http://mycrucialserver.com/grav using the appropriate URL of course.
cd ~/public_html/grav bin/grav clear-cache Clearing cache Cleared: cache/twig/* Cleared: cache/doctrine/* Cleared: cache/compiled/* Cleared: cache/validated-* Cleared: images/* Cleared: assets/* Touched: /home/your_user/public_html/grav/user/config/system.yaml
Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to make your changes.