About uBlog

uBlog is a small Java application that serves a folder of Markdown files as a blog. It uses a simple URL scheme, renders pages to HTML, and keeps content, templates, user properties, and images in filesystem folders.

Philosophy

The project favors a small footprint and few dependencies over a conventional web stack. HTTP is handled directly with Java sockets rather than a web or application server. Markdown rendering and Mustache templates provide the presentation layer; the remaining application code is intentionally straightforward. Configuration has explicit defaults, and there is no database in the current runtime path.

The container starts the JVM with an 8 MB initial and maximum heap. That is a deliberately small starting point, not a performance guarantee: actual memory needs depend on the content, traffic, and runtime environment.

Current state

The project reached it's first (minimal) version with a basic set of functionalities. It is able to create / update / delete and render markdown documents. Uses a simple folder structure to parse documents and manage files and images. It handles images and file uploads as well. There are several templates available for the project and new templates can be created or generated without changing the engine itself.

The project is currently in use (this current product page is also done via uBlog). It can be cloned from GitHub or downloaded directly from DockerHub.

The project is still in active development and new features are expected to pop up.

Support

You can support the project by starting using it and giving feedback here.

Thank you!