A self-hosted open-source blog CMS with site-wide SEO and Google AdSense.

BlogLoom brings Markdown authoring, content management, reader interaction and analytics into one self-hosted platform. Manage SEO, feeds and Google AdSense settings from the console, with one-command Docker deployment and version upgrades.

Quick start →Read the docs

cp bin/local/deploy.conf.example bin/local/deploy.conf
bin/local/upgrate-sql.sh

cd blog-backend
mvn spring-boot:run

cd blog-cms-ui
npm install
npm run dev
# http://localhost:8079

cd blog-view-ui
npm install
npm run dev
# http://localhost:8080

Batteries included

3 appsFrontend, admin and API run and build independently

Full loopWrite → review → publish → engage → analyze

Core principles

Built around the whole content lifecycle.

BlogLoom brings posts, categories, tags, columns, moments, comments and site configuration into one content model, shared by the public blog and the admin console through a single REST API.

Decoupled — the public site, admin console and REST API build and run independently.
Markdown first — Markdown editing, table of contents, code blocks, images and descriptions.
Configurable site — name, avatar, carousel, social links, friends and about page in one place.

See the architecture →

Capabilities

Everything a blog platform needs.

Authoring

Markdown editor, local knowledge base, categories, tags, columns and publishing options.

Learn more →

Public blog

Home, articles, archive, search, moments, custom sections and comments.

Learn more →

Admin console

Dashboard, content management, recycle bin, site settings, SEO & ads, and logs.

Learn more →

SEO & monetization

Server-rendered public pages, robots / sitemap / rss, site verification and Google AdSense.

Learn more →

Image hosting

Local upload plus Aliyun OSS storage, with a connectivity test.

Learn more →

Analytics

PV, UV, content counts, category/tag post aggregation, visitor map.

Learn more →

Deployment

Environment, installation, one-click Docker deployment, configuration and troubleshooting.

Learn more →

Get started

Ready to launch your blog?

Follow the quick start to initialize the database, run the backend, and launch both the public blog and the admin console. All you need is JDK, Maven and Node.js; you can also deploy with Docker in one command, with no JDK or Node.js on the server.

Start building →

FAQ

What are the runtime requirements?

JDK 8+, Maven 3.6+, Node.js 16+, plus MySQL 5.7+. See Environment.

What is the default admin account?

After importing the full SQL, the default account is admin with password 123456. Change it immediately after the first login.

Which image storage options are supported?

Local upload is built in, with Aliyun OSS integration. See Image storage.

Can I extend it?

Yes. The backend is clearly layered, and the public site and admin console are independent, making it easy to change themes or add APIs.