Latest Release

5.1.0 was released on Mar 27, 2024 and is a major release providing Static Server Rendering support for Blazor in .NET 8. This release includes 263 pull requests by 6 different contributors, pushing the total number of project commits all-time to over 5100. The Oqtane framework continues to evolve at a rapid pace to meet the needs of .NET developers.

Oqtane Framework

Oqtane is an open source CMS and Application Framework that provides advanced functionality for developing web, mobile, and desktop applications on .NET. It leverages Blazor to compose a fully dynamic digital experience which can be hosted on Blazor Server, Blazor WebAssembly, or Blazor Hybrid (via .NET MAUI).

Oqtane is being developed based on some fundamental principles which are outlined in the Oqtane Philosophy.

Please note that this project is owned by the .NET Foundation and is governed by the .NET Foundation Contributor Covenant Code of Conduct

Getting Started

Using Version 5:

Install .NET 8 SDK.
Install the latest edition (v17.8 or higher) of Visual Studio 2022 with the ASP.NET and web development workload enabled. Oqtane works with ALL editions of Visual Studio from Community to Enterprise. If you wish to use LocalDB for development ( not a requirement as Oqtane supports SQLite, mySQL, and PostgreSQL ) you must also install the Data storage and processing.
Clone the Oqtane dev branch source code to your local system.
Open the Oqtane.sln solution file.
Important: Build the solution.
Make sure you specify Oqtane.Server as the Startup Project
Run the application.

Installing an official release:

A detailed set of instructions for installing Oqtane on IIS is located here: Installing Oqtane on IIS
Instructions for upgrading Oqtane are located here: Upgrading Oqtane

Additional Instructions

If you have already installed a previous version of Oqtane and you wish to do a clean database install, simply reset the DefaultConnection value in the Oqtane.Server\appsettings.json file to "". This will trigger a re-install when you run the application which will execute the database installation.
If you want to submit pull requests make sure you install the Github Extension For Visual Studio. It is recommended you ignore any local changes you have made to the appsettings.json file before you submit a pull request. To automate this activity, open a command prompt and navigate to the /Oqtane.Server/ folder and enter the command "git update-index --skip-worktree appsettings.json"

Video Series

If you are getting started with Oqtane, a series of videos are available which explain how to install the product, interact with the user interface, and develop custom modules.

Oqtane Marketplace

Explore and enhance your Oqtane experience by visiting the Oqtane Marketplace. Discover a variety of modules, themes, and extensions contributed by the community. Visit Oqtane Marketplace

Documentation

There is a separate Documentation repository which contains a variety of types of documentation for Oqtane, including API documentation that is auto generated using Docfx. The contents of the repository is published to Githib Pages and is available at https://docs.oqtane.org

Roadmap

This project is open source, and therefore is a work in progress...

Backlog (TBD)

Azure Autoscale support (ie. web farm)
Folder Providers
Generative AI Integration

5.1.1 (Apr 2024)

Stabilization improvements

5.1.0 (Mar 27, 2024)

Migration to the new unified Blazor approach in .NET 8 (ie. blazor.web.js)
Static Server Rendering (SSR) support

5.0.2 (Jan 25, 2024)

Stabilization improvements

5.0.1 (Dec 21, 2023)

Stabilization improvements

5.0.0 (Nov 16, 2023)

Migration to .NET 8

4.0.6 ( Oct 16, 2023 )

Stabilization improvements

4.0.5 ( Sep 26, 2023 )

Stabilization improvements

4.0.4 ( Sep 25, 2023 )

Stabilization improvements
User Import

4.0.3 ( Aug 29, 2023 )

Stabilization improvements

4.0.2 ( Aug 9, 2023 )

Stabilization improvements

4.0.1 ( Jul 18, 2023 )

Stabilization improvements

4.0.0 ( Jun 26, 2023 )

Migration to .NET 7
Improved JavaScript, CSS, and Meta support
Optimized Client Assembly Loading
Routable Modules (ie. declarative configuration)
Site Template improvements
IEventSubscriber interface

3.4.3 ( May 3, 2023 )

Stabilization improvements

3.4.2 ( Mar 29, 2023 )

Stabilization improvements

3.4.1 ( Mar 13, 2023 )

Stabilization improvements

3.4.0 ( Mar 12, 2023 )

Permissions performance optimization
Connection string management improvements
XML site map generator
OIDC integration with User Profiles

3.3.1 ( Jan 14, 2023 )

Stabilization improvements

3.3.0 ( Jan 12, 2023 )

Dynamic Authorization Policies
Entity-Level Permissions
Extended Module Permissions

3.2.1 ( Oct 17, 2022 )

Stabilization improvements
Server Event System

3.2.0 ( Sep 13, 2022 )

.NET MAUI / Blazor Hybrid support
Upgrade to Bootstrap 5.2

3.1.3 ( Jun 27, 2022 )

Stabilization improvements

3.1.2 ( May 14, 2022 )

Stabilization improvements

3.1.1 ( May 3, 2022 )

Stabilization improvements

3.1.0 ( Apr 5, 2022 )

User account lockout support
Two factor authentication support
Per-site configuration of password complexity, lockout criteria
External login support via OAuth2 / OpenID Connect
Support for Single Sign On (SSO) via OpenID Connect
External client support via Jwt tokens
Downstream API support via Jwt tokens
CSS resource hierarchy support
Site structure/content migration
Event log notifications
404 page handling
Property change component notifications
Support for ES6 JavaScript modules

3.0.3 ( Feb 15, 2022 )

Url fragment and anchor navigation support
Meta tag support in page head
Html/Text content versioning support

3.0.2 ( Jan 16, 2022 )

Default alias specification, auto alias registration, redirect logic
Improvements to visitor tracking and url mapping
Scheduler enhancements for stop/start, weekly and one-time jobs
Purge job for daily housekeeping of event log and visitors
Granular security filtering for Settings

3.0.1 ( Dec 12, 2021 )

Url mapping for broken links, content migration
Visitor tracking for usage insights, personalization
User experience improvements in Page and Module management

3.0.0 ( Nov 11, 2021 )

Migration to .NET 6
Blazor hosting model flexibility per site
Blazor WebAssembly prerendering support

2.3.1 ( Sep 27, 2021 )

Complete UI migration to Bootstrap 5 and HTML5 form validation
Improve module/theme installation and add support for commercial extensions
Replace System.Drawing with ImageSharp
Image resizing service

2.2.0 ( Jul 6, 2021 )

Bootstrap 5 Upgrade
Package Service integration
Default and Shared Resource File inclusion
Startup Error logging
API Controller Validation and Logging

2.1.0 ( Jun 4, 2021 )

Cross Platform Database Support ( ie. LocalDB, SQL Server, SQLite, MySQL, PostgreSQL ) - see #964
Utilize EF Core Migrations - see #964
Public Content Folder support
Multi-tenant Infrastructure improvements
User Authorization optimization
Consolidation of Package Management
Blazor Server Pre-rendering
Translation Package installation support

2.0.2 ( Apr 19, 2021 )

Assorted fixes and user experience improvements

2.0.1 ( Feb 27, 2021 )

Complete Static Localization of Admin UI

2.0.0 ( Nov 11, 2020 )

Migration to .NET 5
Static Localization ( ie. labels, help text, etc.. )
Improved JavaScript Reference Support
Performance Optimizations
Developer Productivity Enhancements

1.0.0 ( May 19, 2020 )

Migration to .NET Core 3.2
Multi-Tenant ( Shared Database & Isolated Database )
Modular Architecture
Headless API with Swagger Support
Dynamic Page Compositing Model / Site & Page Management
Authentication / User Management / Profile Management
Authorization / Roles Management / Granular Permissions
Dynamic Routing
Extensibility via Custom Modules
Extensibility via Custom Themes
Event Logging / Audit Trail
Folder / File Management
Recycle Bin
Scheduled Jobs ( Background Processing )
Notifications / Email Delivery
Seamless Upgrade Experience
Progressive Web Application Support
JavaScript Lazy Loading
Dynamic CSS/Lazy Loading

POC ( May 9, 2019 )

Initial public release on GitHub
.NET Core 3.0

Background

Oqtane was created by Shaun Walker and is inspired by the DotNetNuke web application framework. Initially created as a proof of concept, Oqtane is a native Blazor application written from the ground up using modern .NET Core technology and a Single Page Application (SPA) architecture. It is a modular application framework offering a fully dynamic page compositing model, multi-site support, designer friendly themes, and extensibility via third party modules.