Installation
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:
- Visit the Official Oqtane Releases page on GitHub.
- Browse the list of releases to find the version you need.
- Click on the release to view its details.
- 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:
- Open the
Oqtane.Server\appsettings.jsonfile. - Locate the
DefaultConnectionvalue and set it to"". - Run the application to trigger the re-installation process, which will execute the database installation scripts.
Upgrade
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.
Development
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.
Windows
- Windows Visual Studio Development: Install Oqtane quickly for development, primarily for Visual Studio and Windows development.
- Windows Visual Studio Code Development: Install Oqtane quickly for development, primarily for Visual Studio Code and Windows development.
Linux
- Linux Visual Studio Code Development: Install Oqtane quickly for development, primarily for Visual Studio Code and Linux development.
Deploy
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:
Azure
Install Oqtane using the Deploy to Azure feature:
- Deploy Oqtane To Azure: This guide shows you how to install Oqtane using the above Deploy To Azure feature.
Windows IIS
Install Oqtane with various configurations on Windows using IIS:
- Install Oqtane with IIS Express and SQL Express: This guide shows you how to install Oqtane on Windows using IIS Express and SQL Express Server.
- Install Oqtane with IIS Express and LocalDB: This guide shows you how to install Oqtane on Windows using IIS (Express) and LocalDb.
- Install Oqtane with IIS and SQL Server: This guide shows you how to install Oqtane on Windows using IIS and SQL Server.
Linux Apache
Install Oqtane with Apache on Linux (Ubuntu) with MySQL or PostgreSQL:
- Install Oqtane with Apache and MySQL: This guide shows you how to install Oqtane on Linux using Apache and MySQL.
- Install Oqtane with Apache and PostgreSQL: This guide shows you how to install Oqtane on Linux using Apache and PostgreSQL.
Resources
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.