installation

okommerce ships as a self-contained ASP.NET Core 9 application. the recommended deployment is Windows Server with IIS as a reverse proxy in front of Kestrel, but Linux + Kestrel works equally well.

prerequisites

• .NET 9 runtime
• SQL Server 2022 (Standard or Enterprise)
• IIS 10+ (Windows) or Nginx (Linux)
• 2 GB RAM minimum, 8 GB recommended for production

windows / IIS

1. install the .NET 9 hosting bundle. 2. unzip okommerce to C:\inetpub\wwwroot\okommerce. 3. create a SQL Server database and user. 4. update appsettings.json with your connection string. 5. create an IIS site pointing to the folder.

linux / kestrel

1. install .NET 9 SDK. 2. unzip okommerce to /var/www/okommerce. 3. configure systemd service. 4. set up Nginx as reverse proxy.

full step-by-step instructions including screenshots and troubleshooting are in the README of the github repo.