Table of Contents


Oqtane is a modular application framework that allows you to create dynamic web sites and applications using Blazor and .NET MAUI. Oqtane supports various deployment scenarios and databases. This section provides installation instructions for different environments and configurations.

Download an Official Release

Find the official Oqtane releases on GitHub and follow these steps to download:

  1. Visit the Official Oqtane Releases page on GitHub.
  2. Browse the list of releases to find the version you need.
  3. Click on the release to view its details.
  4. Download the release package by clicking on the appropriate link.

Reset an Existing Oqtane Installation

If you need to perform a clean database install for a previous version of Oqtane, follow these steps:

  1. Open the Oqtane.Server\appsettings.json file.
  2. Locate the DefaultConnection value and set it to "".
  3. Run the application to trigger the re-installation process, which will execute the database installation scripts.


Learn how to upgrade your existing Oqtane installation manually or through an automated process:

  • Upgrading Oqtane: This section provides information on how to upgrade your existing Oqtane installation manually or through an automated process.


This section provides installation instructions for development purposes. You can choose between Windows or Linux development environments and use Visual Studio or Visual Studio Code as your IDE.




This section provides installation instructions for deploying Oqtane to various environments using a release package. You will learn how to install the prerequisites, create a database, and configure the web server for your Oqtane application.

You can choose between the following deployment options:


Install Oqtane using the Deploy to Azure feature:

Windows IIS

Install Oqtane with various configurations on Windows using IIS:

Linux Apache

Install Oqtane with Apache on Linux (Ubuntu) with MySQL or PostgreSQL:


Explore additional installation resources and access the Oqtane blog and GitHub repository:

  • Oqtane Installation Troubleshooting Tips: If you encounter issues during the installation, upgrade, development, or deployment process, you can refer to our troubleshooting tips.
  • Oqtane Supported Databases: Find detailed information on all databases supported by Oqtane for both Windows and Linux.
  • Oqtane Installation Resources: Access comprehensive installation guides and resources for deploying Oqtane on various platforms.
  • Oqtane Blog: Stay updated with the latest news, announcements, and insights from the Oqtane community by exploring the Oqtane blog.
  • Oqtane GitHub Repository: Access the Oqtane framework's GitHub repository to explore the source code, contribute to development, and stay informed about the latest updates and releases.

← Back to Administration Documentation Manuals Home Page