A simple Markdown based blog that you can use every day.
- Very usable
- Customizable
- Simple to run
This should be fairly easy to install, if you have Python installed.
$ pip install mblog
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.
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
.
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.
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=
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.
Reach out to me for any feedback.
Now Enjoy!
- Author: Karthik Kumar Viswanathan
- Web : https://karthikkumar.org
- Email : karthikkumar@gmail.com