Bludit

Bludit is a web application to build your own website or blog in seconds. It’s completely free and open source. Bludit is a Flat-File CMS, which means that it uses files in JSON format to store the content: you don’t need to install or configure a database. You only need a web server with PHP support.


Note

For this guide you should be familiar with the basic concepts of

License

Bludit is released under the MIT License.

All relevant legal information can be found here

Prerequisites

We’re using PHP in the stable version 8.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '8.1'
[isabell@stardust ~]$

Your blog domain needs to be setup:

[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$

Installation

cd to your document root, then download the latest version of Bludit from Github__.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/html/
[isabell@stardust html]$ wget https://github.com/bludit/bludit/archive/refs/tags/3.14.1.tar.gz
[…]
Saving to: ‘3.14.1.tar.gz’

   [    <=>                                ] 1,016,833   1.58MB/s   in 0.6s

2022-12-15 20:02:16 (1.58 MB/s) - ‘3.14.1.tar.gz’ saved [1016833]
[isabell@stardust html]$

Untar the archive and then delete it.

[isabell@stardust html]$ tar -xzvf 3.14.1.tar.gz --strip-components=1
bludit-3.14.1/.github/
[…]
bludit-3.14.1/install.php
[isabell@stardust html]$ rm 3.14.1.tar.gz
[isabell@stardust html]$

Finishing installation

Now point your Browser to your installation URL https://isabell.uber.space/install.php. Complete the form and follow the installation instructions.

You will need to enter the following information:

  • language: the language you prefer.

  • admin password: set up your admin password.

Tuning

For plugins, themes and other stuff go to Bludit.

Updates

Note

Check the update feed regularly to stay informed about the newest version.

Follow the Update instructions in the Bludit documentation__.

Note

The files in the directory /bl-content should not be deleted. There the user accounts and other important stuff is stored.


Tested with Bludit 3.14.1, Uberspace 7.14.0, PHP 8.1

Written by: Christian Kantelberg <uberlab@mailbox.org>