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.

IMPORTANT: Moonglade will move to .NET 8 LTS in November 2023 with v14.x release

• Please use stable code from Release branch rather than master branch.

• HTTPS is required, and it is recommended to enable HTTP/2 support on your web server.

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

There is no automated script to deploy it, you need to manually create all the resources.

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

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

docker-compose build
docker-compose up

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

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

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

Update your database connection string in appsettings.*.json

"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 and run ./src/Moonglade.sln

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

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

You can choose one authentication provider from below.

See Wiki document

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

ImageStorage controls how blog post images are stored.

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.

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
}

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

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

See https://github.com/EdiWang/Moonglade.ContentSecurity

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.

• System Settings
• Security Headers (CSP, XSS, etc.)

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

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

• zchwei
• yycoding
• 51azure
• Zhuangkh
• HueiFeng
• Leslie Wang
• AllenMasters
• Hao's House
• Sascha.Manns
• 王高峰博客

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

The following disclaimer applies to the software named "Moonglade" developed by Edi Wang and other contributors (hereinafter referred to as "the software developer"):

This project is not affiliated with Microsoft Corporation. All product names, logos, and brands are property of their respective owners. All company, product and service names used in this website are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.

The software developer does not provide any warranties or guarantees regarding the functionality, performance, or suitability of Moonglade for any specific purpose. The software is provided "as is," and the software developer shall not be held liable for any direct or indirect damages arising from the use or inability to use Moonglade.

Moonglade does not send any user data or information to any government, including the Chinese government. The software is designed to prioritize and respect user privacy.

While using Moonglade, please note that the platform on which you deploy the software may collect data and usage information. This data collection is solely the responsibility of the platform and not the software developer. We encourage you to review thier privacy policy and terms of service of the platform to understand how your data is handled.

As a user of Moonglade, it is your responsibility to ensure compliance with applicable laws and regulations regarding data privacy and usage. The software developer shall not be held liable for any misuse, unauthorized access, or mishandling of data by the user or the platform on which Moonglade is deployed.

The software developer may release updates or modifications to Moonglade from time to time. It is recommended that users stay informed about these updates and apply them to ensure optimal performance and security.