Since our Oqtane environment includes the full source code of oqtane, here's what you need to do.

This was last verified 2026-08 for Oqtane 10.02.

Prerequisites

This checklist assumes that you have set up Oqtane in the standard way according to the initial checklist. It assumes that

1. it's a source-code Oqtane
2. that it is still using git and mapped to the original Oqtane master branch
3. The 2sxc-build.config.json has an Oqtane target configured (for later build)
4. Visual Studio is up to date (with the latest .net CLR)

Preparation

1. Backup DB (using SQL Server Studio)
2. Backup file system (typically C:\Projects\2sxc\Oqtane\oqtane.framework) using folder-copy
3. If you have any changes pending in the repo, best make a commit (or ammend the previous commit) - we don't plan on pushing this.

Do Upgrade

1. Pull (rebase) the master branch (run git pull --rebase in the folder)
2. Build Oqtane...

Alternative: Manual Process

1. Rename your old oqtane.framework folder
2. Git clone the current oqtane.framework to the folder
3. Manually update
   1. .gitignore
   2. Oqtane.Server/appsettings.json
      1. DB (connection and type)
      2. Bottom ca. 4 lines with installation ID etc.
4. Copy in the Oqtane.Server folder
   1. 2sxc folder
   2. content folder
5. Update the Oqtane.Server/Properties/launchsettings.json with "hotReloadEnabled": false
6. update the Oqtane.Server.csproj according to the default instructions
7. In debug, rebuild `ToSic.Sxc.Oqt.Package` to ensure 2sxc DLLs are restored in Oqtane
8. Manually build Oqtane
   1. First shared
   2. Then client
   3. then server