Databaseless Blogging Platform, Flat-File Blog and Flat-File CMS
Clone or download
Pull request Compare This branch is 13 commits ahead, 2 commits behind danpros:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


HTMLy is an open source databaseless web publishing platform that prioritizes simplicity and speed. HTMLy can be referred to as a Flat-File Blog or Flat-File CMS, since it will also manage your content.

You do not need to use a VPS to run HTMLy, shared hosting or even free hosting should work as long as the host supports at least PHP 5.3.


Visit HTMLy demo as blog.


  • Admin Panel
  • Markdown editor with live preview and image upload
  • Categorization with category and tags (multiple tagging support)
  • Static Pages (e.g. Contact Page, About Page)
  • Meta canonical, description, and rich snippets for SEO
  • Pagination
  • Author Page
  • Multi author support
  • Social Links
  • Disqus Comments (optional)
  • Facebook Comments (optional)
  • Google Analytics
  • Built-in Search
  • Related Posts
  • Per Post Navigation (previous and next post)
  • Body class for easy theming
  • Breadcrumb
  • Archive page (by year, year-month, or year-month-day)
  • OPML
  • RSS Feed
  • RSS 2.0 Importer (basic)
  • Sitemap.xml
  • Archive and Tag Cloud Widget
  • SEO Friendly URLs
  • Teaser thumbnail for images and Youtube videos
  • Responsive Design
  • User Roles
  • Online Backup
  • File Caching
  • Auto Update
  • Post Draft


HTMLy requires PHP 5.3 or greater and php-xml package.


If you have an OpenSSL enabled server (usually enabled by default), use the installer and read the following instructions to get started. If you don't have OpenSSL, please download the latest version, extract it, then upload the extracted files to your server. Also, make sure the installation folder is writeable by your server.


Rename config.ini.example inside the config folder to config.ini (or you can create a new config/config.ini file) then change the site settings there.

Create YourUsername.ini inside the config/users folder or simply rename the username.ini.example file and write down your password there:

password = YourPassword

In addition, HTMLy support admin user role. To do so, simply add the following line to your choosen user:

role = admin

Users assigned with the admin role can edit/delete all users' posts.

To access the admin panel, add /login to the end of your site's URL. e.g.


The following is an example configuration for lighttpd:

$HTTP["url"] =~ "^/config" {
  url.access-deny = ( "" )
$HTTP["url"] =~ "^/system/includes" {
  url.access-deny = ( "" )
$HTTP["url"] =~ "^/system/admin/views" {
  url.access-deny = ( "" )

url.rewrite-once = (
  "^/(themes|system|vendor)/(.*)" => "$0",
  "^/(.*\.php)" => "$0",

  # Everything else is handles by htmly
  "^/(.*)$" => "/index.php/$1"


The following is a basic configuration for Nginx:

server {
  listen 80;

  root /usr/share/nginx/html;

  access_log /var/log/nginx/access.log;
  error_log /var/log/nginx/error.log error;

  index index.php;

  location ~ /config/ {
     deny all;

  location / {
    try_files $uri $uri/ /index.php?$args;

  location ~ \.php$ {
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME   $document_root$fastcgi_script_name;
        include        fastcgi_params;


Need a free server to test HTMLy? try OpenShift using the HTMLy OpenShift QuickStart for easy deployment.

Quick install:

![Click to install OpenShift]( to install.svg)

Making a secure password

Passwords can be stored in username.ini (where "username" is the user's username) in either plaintext, encryption algorithms supported by php hash or bcrypt (recommended). To generate a bcrypt encrypted password:

$ php -a
> echo password_hash('desiredpassword', PASSWORD_BCRYPT);

This will produce a hash which is to be placed in the password field in username.ini. Ensure that the encryption field is set to bcrypt.

Both Online or Offline

The built-in editor found in the admin panel, also provides you the ability to write to Markdown files offline by uploading them (see naming convention below) into the content/username/blog/category/type/:

  • username must match config/users/username.ini.
  • category must match the inside content/data/category/ except the uncategorized category.
  • type is the content type. Available content type post, video, audio, link, quote.

For static pages you can upload it to the content/static folder.


The default category is Uncategorized with slug uncategorized and you do not need to creating it inside content/data/category/ folder. But if you write it offline and want to assign new category to specific post you need to creating it first before you can use those category, example content/data/category/ with the following content:

<!--t New category title t-->
<!--d New category meta description d-->

New category info etc. 

The slug for the new category is new-category (htmly removing the file extension). And for full file directory:


File Naming Convention

When you write a blog post and save it via the admin panel, HTMLy automatically create a .md file extension with the following name, example:


Here's the explanation (separated by an underscore):

  • 2014-01-31-12-56-40 is the published date. The date format is yyyy-mm-dd-hh-mm-ss
  • tag1,tag2,tag3 are the tags, separated by commas
  • databaseless-blogging-platform-flat-file-blog is the URL

For static pages, use the following format:


In the example above, the / creates the URL:

Thus, if you write/create files offline, you must name the .md file in the format above.

For static subpages, use the following format:


This will create the URL:

Content Tags

If you are writing offline, you need specify the content tags below:


<!--t Title t-->

Meta description

<!--d The meta description d-->


This is just the tags display and for the slug is in the filename.

<!--tag Tag1,Tag2 tag-->

Featured image

Post with featured image.

<!--image image-->

Featured youtube video

Post with featured youtube video.

<!--video video-->

Featured soundcloud audio

Post with featured soundcloud audio.

<!--audio audio-->

Featured link

Post with featured link.

<!--link link-->

Featured quote

Post with featured quote.

<!--quote Premature Optimization is The Root of All Evil quote-->


Example of how your post would look like:

<!--t Here is the post title t-->
<!--d The meta description d-->
<!--tag Tag1,Tag2 tag-->
<!--video video-->

Paragraph 1

Paragraph 2 etc.



  1. Fork and edit
  2. Submit pull request for consideration


Copyright / License

For copyright notice please read COPYRIGHT.txt. HTMLy is licensed under the GNU General Public License Version 2.0 (or later).