Pubvana is one of the easiest CMS you can use for blogging and building/managing your personal websites or small business websites.
The CMS was built using Twitter Bootstrap front-end framework and Bootstrap HTML, CSS, and JS framework often used for developing responsive, mobile-first projects on the web.
Pubvana is multi-lingual, provides ready-made pages you can use for fast blogging and completely free to use for both personal and commercial purposes.
Visitors can subscribe to your blog and get blog posts in their inbox without the need to log in read your latest post.
There are basically two ways you can use to install Pubvana.
But first, let’s see what the required prerequisites are.
To successfully install Pubvana and have it behave as expected, you need to have:
- the latest PHP 7+ version
- MySQL or MariaDB Database
- SSH shell access to your server/account
- mod_rewrite for prettier URLs
- PHP cURL module for automatic updates
- PHP ZipArchive module for automatic updates
- Composer (if installing manually via the command-line)
If you are hosting Pubvana on our hosting platform, requirements #1 to #6 have already been met.
The last one, Composer will be needed if you are installing Pubvana manually.
How To Install Pubvana In 5 Minutes With Softaculous
Now, let’s start with the easiest method of installing Pubvana and that is with the Softaculous application installer.
First, log in to your cPanel server.
Then visit the Software >>> Softaculous. This will load and bring you to our 1-click application page.
Scroll down to the “Blog” section or type to search for Pubvana.
Fill out the details such as:
- Choose the Installation URL (decide whether you are installing Pubvana on your main website root folder or on a sub-domain or sub-folder).
- Site Name
- Site Description
- Admin Email Address
- Admin Password (visit https://1password.com/password-generator/ or use your password manager to generate a strong password.)
- Admin Username
- Admin First Name
- Admin Last Name
Save these in a safe place because you will need them to access your installation later.
If you so choose, you can click the Advanced Options and make changes to the:
- Database Name
- DB Table Prefix
- Backup Location
- Automated backups
- Backup Rotation
Do this ONLY if you know what you are doing or leave the defaults.
If you want to send the installation details to someone (e.g. your developer or web designer), fill the “email installation details to” field.
Click on the “Install” button to start the installation or on any of the available buttons to learn more about Pubvana.
The script will create the database, install the files, set appropriate permissions Pubvana needs to be online and show you your Pubvana admin URL.
How To Install Pubvana Manually via The Command-Line
Access your cPanel server via an SSH Terminal.
Before you do, make sure you have imported your public_key to the server and authorized it as our systems don’t permit password authentication.
See https://dashboard.webhostingmagic.com/knowledgebase/10/How-To-Add-Public-SSH-Key-To-cPanel-For-SSH-Access.html for details.
This will bring you to “/home/$username/”
Move to your site’s public_html directory with:
cd public_html/ && ls -al
If you have created a sub-domain (pubvana.domain_name.com) and want to install Pubvana on it, move to the directory.
If you have created a sub-folder (domain_name.com/pubvana) and want to install Pubvana there, move to the folder.
Now pull all files using Composer (https://getcomposer.org/download/):
If you’ve installed Composer in your site’s root directory with:
php composer.phar create-project enlivenapp/pubvana
If globally, then use:
composer create-project enlivenapp/pubvana
To download the development branch, use:
[php ]composer[.phar] create-project --stability dev enlivenapp/pubvana.
This branch should not be used for production sites.
Move all files out of the created ~/pubvana/pubvana/ directory to your root directory.
Create a database and database user with a strong password via cPanel >> Home >> Databases >> MySQL Database Wizard.
To set up a database in cPanel, perform the following steps:
- in the New Database text box, enter a name for the database and click Next Step.
- in the Username text box, enter a name for the user who you wish to allow to manage the database.
- enter and confirm the new password in the appropriate text boxes.
- click Create User.
- select the checkboxes that correspond to the privileges that you want to grant the user, or select ALL PRIVILEGES.
- click Next Step.
The system will display a message indicating that you have successfully set up the database and user account.
Now head back to https://example.com via a web browser to run the automated database installer.
Follow the steps to complete the installation.
Pubvana will look for a locally installed copy of Composer (composer.phar) in the root directory, the same folder index.php is in.
If it is not there, you may need to run “composer update” to get that corrected.
After the installation, do go back to cPanel File Manager and make sure these directories have been created with the right permissions:
- /pubvana/config
- /pubvana/cache/sessions
- /pubvana/cache/assets
- /uploads
- / (project’s root folder)
How To Upgrade Pubvana Automatically or Manually
If you have used our Softaculous 1-click installer to install Pubvana and have selected “automatic upgrade” during the installation, it will ensure that it is backed up and updated when a new version is released.
If Pubvana is manually installed, visit Pubvana Admin Panel and click Updates.
If there is an available update, you will see the update option.
If there is an update and the update is missing, use “composer update” manually to upgrade Pubvana.
How To Troubleshoot Your Pubvana Installation
If you receive the error such as:
"- PHP Error …iconv.internal_encoding is deprecated OR …mbstring.internal_encoding is deprecated"
when loading the Media Manager, edit .htaccess and set SetEnv CI_ENV production then save the changes.
If you can not add, delete, or otherwise modify folders and files, check and if needed, modify the /uploads/ read and write permission.