Install Oqtane and 2sxc
Read the blog + video + checklist we created on installing Oqtane and 2sxc.
Oqtane and 2sxc Version Compatibilities
Tip
Oqtane is still being heavily improved and growing with the newest .net core frameworks. Because of this, extensions like 2sxc can quickly become incompatible with the latest enhancements, so here we'll maintain a list of Oqtane / 2sxc versions.
| Oqtane V. | Best | Compatible | Incompatible | Comments |
|---|---|---|---|---|
| 2.0 | 12.00 | ✅ 12.00 - 12.02 | ⛔ 12.04 | |
| 2.1 | 12.04 | ✅ 12.04 | ⛔ 12.05 | Changes in Multi-Language |
| 2.2 | 12.06 | ✅ 12.04+ | ⛔ pre 12.04 | Changes in Bootstrap / jQuery & Authentication |
| 2.3 | 12.10 | ✅ 12.04+ | ⛔ pre 12.04 | |
| 3.0 | 12.10 | ✅ 12.10+ | ⛔ pre 12.10 / 13.06+ | Changes in .net 6 |
| 3.00.01 | 13.02 | ✅ 13.01+ | ⛔ pre 13.01 / 13.06+ | Oqtane save/delete module settings |
| 3.00.02 | 13.02 | ✅ 13.01+ | ⛔ pre 13.01 / 13.06+ | |
| 3.00.03 | 13.02 | ✅ 13.01+ | ⛔ pre 13.01 / 13.06+ | |
| 3.01.+ | 14.12 | ✅ 13.06 - 14.12 | ⛔ pre 13.06 / 15+ | Changes in Oqtane 3.3 |
| 3.3+ | latest | ✅ 15.01+ | ⛔ pre 15.01 | Changes in Oqtane 3.3 |
Upgrade Existing Installations
When upgrading an existing Oqtane/2sxc you should follow these steps:
- make sure that a compatible 2sxc exists
- upgrade Oqtane first - possibly 2sxc then stops working
- then upgrade 2sxc