Live Split Preview
Instant syntax highlighting, tables, and typography formatting
Open Source Blog System
ZrLog, Open Source Blog System
Write and publish articles with Markdown, and manage your own blog content and site
Quick install · Linux / macOS
Installation options
curl -fsSL https://www.zrlog.com/install.sh | bash
Requires unzip · Installs to ~/zrlog · Runtime included
Article Editing
Markdown Writing with Live Split Preview
Write Markdown with a live preview alongside the editor. Import a Markdown file, use AI writing assistance, pin articles, and manage categories and tags
Local Markdown Import
Import local .md files with draft autosave support
Categories, tags and pinned articles
Organize articles by category and tag, and choose which articles stay at the top of your home page
AI-Assisted Writing
The configurable article assistant can suggest titles, prepare summaries and polish drafts. You review and publish the article
ZrLog Editing Interface
Article Editing & Live Preview
Capabilities
Content management, writing, deployment and maintenance
Covering the core stages from content management and writing to deployment and long-term maintenance
Content Ownership
Applications, databases, and media assets stay in an environment you choose and manage
Markdown writing
Out-of-the-box Markdown editor with live split preview, file import, and configurable AI writing assistance
Deployment options
Use Native with its bundled runtime locally, or Generic ZIP with JDK 11+; Docker Compose is recommended for servers
Backups and updates
Online upgrades, pre-upgrade backup status and risk confirmation, and static page generation to reduce origin load
Getting Started
From Setup and Writing to Publishing and Maintenance
For local use, start with Native + SQLite; for long-running servers, use Docker Compose + MySQL
-
Set Up
Choose Native, Generic ZIP, or Docker Compose for your environment
-
Write
Draft with Markdown, preview changes in real time, and use the article assistant when needed
-
Publish
Choose a category and tags, preview the article, and publish it to your blog
-
Maintain
Back up regularly, follow upgrade prompts, and enable static page generation as needed
Choose an Installation Method
Native includes its runtime; Generic ZIP requires JDK 11+; servers can use the official Docker Compose configuration
View All Packages & DocumentationRun Locally
Native and Generic ZIP
Native includes its runtime and is ready after extraction; Generic ZIP requires JDK 11+. Both support MySQL and SQLite
Select PackageServer Deployment
Docker Compose + MySQL
Official configuration including ZrLog, MySQL 8, health check probes, and volume persistence
View DocsThemes & Plugins
Themes & Functional Extensions
Switch or upload theme ZIP packages directly in admin, and extend storage, backups, and feeds via standalone plugins
hexo-next
Hexo NexT style with two-column layout and dark mode
Minimal Theme
Clean typography optimized for long-form reading
Classic Theme
Classic two-column layout with archive sidebar
Import Hexo articles
Import articles and metadata from Hexo Markdown archives
Database Backup
Export MySQL backups manually or on a schedule and sync them to private storage
Object Storage
Supports Qiniu, Tencent Cloud COS and Alibaba Cloud OSS
RSS Feeds
Generate RSS feeds and sync them to static asset storage
Open Source Resources
FAQ
Common Questions Before You Start
Answers about setup, databases, AI-assisted writing, and long-term maintenance.
Who is ZrLog for?
ZrLog is for users who want to build and maintain a blog and keep writing, publishing, and managing its content over time.
Which installation method should I choose?
For local use, start with Native + SQLite. Use Generic ZIP if JDK 11+ is already available. For a long-running server, use Docker Compose + MySQL. Other deployment options are listed on the download page.
Which databases are supported?
Native and Generic ZIP can use SQLite or an external MySQL database. The official Docker Compose setup uses MySQL 8. Cloudflare D1 is limited to its corresponding advanced deployment path.
What can AI-assisted writing do?
The configurable article assistant can suggest titles, organize summaries, and polish drafts. You still edit, review, and publish the article.
How should I maintain a long-running blog?
Use the database backup plugin, online upgrades, and static page generation as needed. Before upgrading, review backup status and risk notices; choose caching or a CDN based on traffic and deployment.
Ready to Use ZrLog?
Download the package for your environment, or explore the writing and admin interface in the live demo.