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.


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


Bludit is released under the MIT License.

All relevant legal information can be found here


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@stardust ~]$


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
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
[isabell@stardust html]$ rm 3.14.1.tar.gz
[isabell@stardust html]$

Finishing installation

Now point your Browser to your installation URL 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.


For plugins, themes and other stuff go to Bludit.



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

Follow the Update instructions in the Bludit documentation.


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 <>