Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Moonglade Blog

Docker Linux x64

The .NET blog system that optimized for Microsoft Azure. Designed for developers, enabling most common blogging features including posts, comments, categories, archive, tags and pages.

๐Ÿ“ฆ Deployment

  • It is recommended to use stable code from Release rather than master branch.

  • It is recommended to enable HTTP/2 support on your web server.

โ˜ Full Deploy on Azure (Recommend)

This is the way is deployed, by taking advantage of as many Azure services as possible, the blog can run very fast and secure.

But there is no automated script to deploy it, you need to manually create all the resources and configure them.


๐Ÿ‹ Quick Deploy on Azure (App Service on Linux)

Use automated deployment script to get your Moonglade up and running in 10 minutes with minimal Azure components, follow instructions here

๐Ÿ‹ Quick Deploy with Docker-Compose

Simply go the the root folder of this repo and run:

docker-compose build
docker-compose up

That's it! Now open: Browser: http://localhost:8080

๐Ÿง Quick Deploy on Linux without Docker

To quickly get it running on a new Linux machine without Docker, follow instructions here. You can watch video tutorial here.

๐Ÿต Development

Tools Alternative
Visual Studio 2022 v17.4+ Visual Studio Code with .NET 7.0 SDK
SQL Server 2022 SQL Server LocalDB, PostgreSQL or MySQL

๐Ÿ’พ Setup Database

Moonglade supports three types of database. You can choose from SQL Server, PostgreSQL or MySQL.

Update your database connection string in appsettings.*.json

SQL Server

"ConnectionStrings": {
  "MoongladeDatabase": "Server=(localdb)\\MSSQLLocalDB;Database=Moonglade;Trusted_Connection=True;",
  "DatabaseType": "SqlServer"


"ConnectionStrings": {
  "MoongladeDatabase": "Server=localhost;Port=3306;Database=moonglade;Uid=root;Pwd=******;",
  "DatabaseType": "MySql"


"ConnectionStrings": {
  "MoongladeDatabase": "User ID=****;Password=****;Host=localhost;Port=5432;Database=****;Pooling=true;",
  "DatabaseType": "PostgreSql"

๐Ÿ”จ Build Source

Build and run ./src/Moonglade.sln

  • Admin: https://localhost:1055/admin
  • Default username: admin
  • Default password: admin123

โš™ Configuration

This section discuss system settings in appsettings.[env].json. For blog settings, please use "/admin/settings" UI.

For production, it is strongly recommended to use Environment Variables over appsetting.json file.

๐Ÿ›ก Authentication

Microsoft Entra ID

See Wiki document

Local Account (Alternative)

Set Authentication:Provider to "Local". You can manage accounts in /admin/settings/account

๐Ÿ–ผ Image Storage

ImageStorage controls how blog post images are stored.

Azure Blob Storage (Preferred)

You need to create an Azure Blob Storage with container level permission.

  "Provider": "azurestorage"
  "AzureStorageSettings": {
    "ConnectionString": "YOUR CONNECTION STRING",
    "ContainerName": "YOUR CONTAINER NAME"

When configured the image storage to use Azure Blob, you can take advantage of CDN for your image resources. Just enable CDN in admin settings, the blog will get images from CDN.

Minio Blob Storage (Free)

You need to hava an Minio Server.

"Provider": "miniostorage"
"MinioStorageSettings": {
  "EndPoint": "Minio Server Endpoint(eg:localhost:9600)",
  "AccessKey": "Your Access Key",
  "SecretKey": "Your Secret Key",
  "BucketName": "Your BucketName",
  "WithSSL": false

Qiniu Blob Storage (Almost free)

You need to hava an Qiniu cloud account, and use Kodo storage service.

"Provider": "qiniustorage"
"QiniuStorageSettings": {
  "EndPoint": "Your Custom Domain",
  "AccessKey": "Your Access Key",
  "SecretKey": "Your Secret Key",
  "BucketName": "Your BucketName",
  "WithSSL": false

You can also choose File System for image storage if you don't have a cloud option.

  "Provider": "filesystem",
  "FileSystemPath": "C:\\UploadedImages"

๐Ÿคฌ Comment Moderator

๐Ÿ“ง Email Notification

If you need email notification for new comments, new replies and pingbacks, you have to setup the Moonglade.Email Azure Function first, and then enable notification in admin portal.

๐Ÿ”ฉ Others

๐ŸŽ‰ Blog Protocols or Standards

  • RSS
  • Atom
  • OPML
  • Open Search
  • Pingback
  • Reader View
  • FOAF
  • RSD
  • MetaWeblog (Basic Support)
  • Dublin Core Metadata (Basic Support)
  • BlogML - Under triage
  • APML - Not planned
  • Trackback - Not planned

๐Ÿผ Example Blogs

There are a few individuals already setup thier blogs using Moonglade on Azure (Global or China), Alibaba Cloud, Tencent Cloud, etc.

Just Submit PR or issue if you want your blog to be listed here