Bludit is a completely free, open source content management web application that can be used to make your own site or blog in seconds. It is fast, simple and extensible content management system application writen in PHP that uses flat-files to store its content, so you don’t need to install any database.
In this tutorial, we will explain how to install and configure Bludit on Ubuntu 16.04 with PHP-FPM and Nginx.
Requirements
- A server running Ubuntu-16.04 on your system.
- A non-root user with sudo privileges setup on your server.
- A static IP address configure on your server.
Update the System
First, you will need to update the system with the latest version and install necessary packages.
You can do this by running the following commands:
sudo apt-get update -y
sudo apt-get upgrade -y
sudo apt-get install nano wget unzip git curl
Once your system is up-to-date, you can proceed to next step.
Install Nginx, PHP and required PHP modules
First, you will need to install the Nginx web server. You can install it with the following command:
sudo apt-get install nginx
Once Nginx is installed, start nginx service and enable it to start at boot. You can do this with the following command:
sudo systemctl start nginx
sudo systemctl enable nginx
Next, you will need to install the latest stable version of PHP version 7.0 and all necessary modules. You can install all this with the following command:
sudo apt-get -y install php7.0-fpm php7.0-cli php7.0-json php7.0-curl php7.0-gd php7.0-mysql php7.0-mbstring php7.0-xml
Next, you will need to make some changes in php.ini
file:
sudo nano /etc/php/7.0/cli/php.ini
Change the lines as shown below:
memory_limit = 512M
date.timezone = UTC
cgi.fix_pathinfo=0
upload_max_filesize = 100M
post_max_size = 100M
Once you are done, save and close the file.
Next, you will also need to create a new PHP-FPM pool for your user.
You can do this by creating user.conf
file:
sudo nano /etc/php/7.0/fpm/pool.d/user.conf
Add the following lines:
[www-data]
user = www-data
group = www-data
listen = /var/run/php/php7.0-www-data-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0666
pm = ondemand
pm.max_children = 5
pm.process_idle_timeout = 10s
pm.max_requests = 200
chdir = /
Once you are done, save the file and restart PHP-FPM service:
sudo service php7.0-fpm restart
Download Bludit
First, you will need to download the latest version of Bludit from their website.
You can also download the Bludit with the following command:
wget https://s3.amazonaws.com/bludit-s3/bludit-builds/bludit_latest.zip
Once download is complete, extract the downloaded archive to the Nginx default document root directory.
sudo unzip bludit_latest.zip -d /var/www/html/
Next, set proper permission to bludit folder.
sudo chown -R www-data:www-data /var/www/html/bludit
sudo chmod -R 755 /var/www/html/bludit
Once you are done, you can proceed to configure Nginx.
Configure Nginx
Next, you will need to create a Nginx server block for bludit. You can do this by creating a bludit.conf
file inside /etc/nginx/sites-available/ directory:
sudo nano /etc/nginx/sites-available/bludit.conf
Add the following lines:
server {
listen 80;
server_name bludit-demo.com;
root /var/www/html/bludit;
index index.php;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
access_log /var/log/nginx/bludit.access.log;
error_log /var/log/nginx/bludit.error.log;
# Deny direct access to .txt files
location ~* /bl-content/.*\.txt$ {
return 404;
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php/php7.0-www-data-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_intercept_errors off;
fastcgi_buffer_size 16k;
fastcgi_buffers 4 16k;
}
location ~ /\.ht {
deny all;
}
}
Once you are done, save the file and enable Nginx server block. You can enable Nginx server block by creating symlink of bludit.conf
file:
sudo ln -s /etc/nginx/sites-available/bludit.conf /etc/nginx/sites-enabled/
Next, test the Nginx configuration for syntax error with the following command:
sudo nginx -t
Once everything is ok, then restart the Nginx service with the following command:
sudo systemctl restart nginx
Configure Firewall
Before accessing the Bludit, you will need to allow HTTP service through UFW firewall. By default UFW is disabled on your system, so you need to enable it first.
You can enable it with the following command:
sudo ufw enable
Once UFW firewall is enabled, you can allow HTTP service by running the following command:
sudo ufw allow http
You can now check the status of UFW firewall by running the following command:
sudo ufw status
Access the Bludit Web Installation Wizard
Once everything is setup properly, it’s time to access Bludit web installation wizard. You can do this through your web browser. Open your favourite web browser and type the URL http://bludit-demo.com or httt://your-ip-address, you should see the following installation screen:
HP_NO_IMG/data/uploads/users/7ecb43a5-b365-4ebf-93d5-f3b632f29f33/625463586.png” alt=”” />
Next, click on the Next
button, you should see the following screen. On this page you’ll need to enter the admin details and click on the Install button.
HP_NO_IMG/data/uploads/users/7ecb43a5-b365-4ebf-93d5-f3b632f29f33/244747600.png” alt=”” />
After providing all the information, you should see the following page:
HP_NO_IMG/data/uploads/users/7ecb43a5-b365-4ebf-93d5-f3b632f29f33/2030727877.png” alt=”” />
Now, you are ready to login from Bludit admin panel.
To do this, open your web browser and type the URL http://your-ip-address/admin and enter the admin username and password, you should see the following dashboard:
HP_NO_IMG/data/uploads/users/7ecb43a5-b365-4ebf-93d5-f3b632f29f33/973431098.png” alt=”” />
Once, installation is completed, it’s highly recommended to set the correct timezone. You can do this from the Admin panel > Settings > Language and timezone > Timezone.
Create Your First Post and Page
Once everything is up-to-date, it’s time to create your own post and page.
To create a new post, log in to your Admin panel and go to New post on the top menu.
Complete the form, write a title and the content for the new post, then click on the button Save.
HP_NO_IMG/data/uploads/users/7ecb43a5-b365-4ebf-93d5-f3b632f29f33/123675893.png” alt=”” />
To create a new page, log in to your Admin panel and go to New page on the top menu.
Complete the form, write a title and a content for the new page, then click on the button Save.
HP_NO_IMG/data/uploads/users/7ecb43a5-b365-4ebf-93d5-f3b632f29f33/2074371358.png” alt=”” />
Conclusion
Congratulation’s! You have successfully installed the Bludit content management system on your server. You can now easily deploy your own blog or web site on server.
For more information about how to manage your Bludit installation, please refer to the official Bludit documentation.