Each developer should easily adjust this recipe to its own needs and local development environment specifics because there are lots of ways how Oqtane can be installed and configured.


  1. Either start with your own Windows 10, Windows Server or create a test VM with Windows 10
  2. Install SQL Server Developer Edition and SSMS 
  3. Install / Configure IIS 10 - this is very important to get right
  1. Install Url Rewrite Module
  2. Install .NET Core Hosting Bundle


  1. Download latest Oqtane.Framework.N.N.N.Install.zip from oqtane.framework git releases
  2. Create Folder awesome.oqtane.me folder in C:\inetpub and unzip Oqtane.Framework.N.N.N.Install.zip to it.
  3. Open IIS Manager and add new website, where is site name: awesome.oqtane.me, physical path points to awesome.oqtane.me folder and host name is: awesome.oqtane.me
  4. Give Allow Modify permission to application pool identity user IIS APPPOOL\awesome.oqtane.me (or whatever your AppPool id is)
  5. For application pool awesome.oqtane.me we need to set No Managed Code for .NET CLR version
  6. Prepare database
  7. Open internet browser and navigate to http://awesome.oqtane.me to start the website and run the oqtane installation.
  8. You should now see the installer dialog. IF NOT - Check for one of the following Issues
    1. Special DNS Issues when Installing on a Real Server with Server-Rendering
    2. Activate Debugging in Oqtane 
  9. In Oqtane installer select, type...
    Database Type: SQL Server.
    Server: (local) .... type your specific SQL server
    Database: awesome.oqtane.me
    Integrated Security: True
    ... on right side under username: host
    Password: Oqtane21!
    Confirm: Oqtane21!
    Email: [email protected]
    Click on [Install Now] and wait 30 sec for installation to finish.
  10. Congratulation! You have installed Oqtane!
    Login with oqtane user host and password Oqtane21!


Now you can start installing additional modules - either directly from NuGet or from Downloads. Here some examples

  1. Activate additional languages todo: checklist
  2. Install the Oqtane Blog Module todo: create checklist
  3. Install the CMS / Structured Content / App-Engine 2sxc
  4. todo: add more