mblog: A minimal markdown blog

A simple Markdown based blog that you can use every day.

Main Features

• Very usable
• Customizable
• Simple to run

Installation

This should be fairly easy to install, if you have Python installed.

$ pip install mblog

Usage

You should be generally able to start it with:

$ mblog

and in case that does not work, as:

$ python -m mblog

In some cases, your python could be named python3, so try:

$ python3 -m mblog

It launches as a web server running on port 5000 and tries to bind on all IP addresses (0.0.0.0).

You can override this behavior by manually specifying the PORT and HOST variables.

In a typical install, you should be able to open http://localhost:5000 in your browser. Use the Login link to sign in. The default password is Password. You should change it by following the directions below.

Database

Typically, when you want to run this on Heroku or a cloud provider, you may want to use a MySQL database than the SQLite provider. Set the DATABASE environment variable to mysql://user:password@host/database.

Storage

By default, this software relies on the local file system. If you wish to use Cloud Hosting, use S3, MinIO or some other service to host your files and images. Then use those links directly when composing your blogs.

Admin Credentials

You typically authenticate via the ADMIN_PASSWORD_HASH variable. Hashed Passwords are obtained by hashing with SHA-256 encoded to Base64:

For the default password which is Password, you would get its hash as 588+9PF8OZmpTyxvYS6KiI5bECaHjk4ZOYsjvTjsIho=

$ echo -n Password | openssl dgst -binary -sha256 | base64
588+9PF8OZmpTyxvYS6KiI5bECaHjk4ZOYsjvTjsIho=

Acknowledgments

The original version of this can be found here.

This was taken and customized for adding File Uploads, Password Hashing, Better Error Handling, Custom Branding with Python2 and Python3 Portability.

Questions?

Reach out to me for any feedback.

Now Enjoy!

• Author: Karthik Kumar Viswanathan
• Web : https://karthikkumar.org
• Email : karthikkumar@gmail.com