Installation, Setup Wizard & Deployment

What are the minimum steps to get an Okommerce store live? At a minimum: obtain the build, point it at a SQL Server database, run it, and complete the first-run setup wizard. How do you obtain and run the Community Edition build? [NEEDS YOUR INPUT for distribution specifics] — In general terms grounded in the platform: the software is distributed to developers as a build they download and run on their own server; a… What happens on first run of the application? On first run the application detects that setup hasn't been completed and presents the first-run setup wizard — a full-screen, step-by-step sequence that configures the deployment. What does the first-run Setup Wizard do, step by step? The wizard turns a fresh install into a configured store. What are the nine steps of the Setup Wizard? The wizard has nine steps: Welcome (intro, plus the guarded full reset) → Shop details (name, domain, support email) → Locale (currency — auto- detected, country, languages with RTL… Is the Setup Wizard resumable if you skip it or leave midway? Yes. How do you re-launch the wizard later, and how does it show what's done vs remaining? A button (placed prominently in the admin) re-launches the setup wizard at any time. Can the same configuration be reached from Settings instead of the wizard? Why does the wizard exist? Yes — the equivalent configuration is also reachable directly from the Settings / developer section, because under the hood the wizard simply writes to the same PlatformSettings store. How do you choose single-vendor vs multi-vendor mode during setup? The Vendor mode step asks you to choose Single or Multi. How do you select which of the six product types are active? The Product types step presents a multi-select of the six types — Physical, Service, Digital, Quotation, Subscription, Rental/Access — and you tick the ones your business needs. How is the store's country, currency, and languages configured at setup? The Locale step captures the operating country, the currency (auto-detected where possible, e.g. How is the domain name captured during setup? The Shop details step captures the domain name (alongside the shop name and support email). How does the wizard bulk-import a catalogue from xlsx/csv? The Upload and Import steps handle catalogue bulk-loading. What does the import preview show before committing? Before any data is written, the preview parses the file (read-only, no writes) and shows what the importer understood: the total row count, the top categories it found, how deep the category tree… How does the importer build the Category → Subcategory → Item Type tree? The importer reads the spreadsheet's Category / Subcategory / Item Type columns and finds-or-creates the three-level category tree from them, de-duplicated via an in-memory cache so that even… How does the importer handle products (create/update by SKU) idempotently? Products are imported idempotently by SKU (falling back to name): for each row the importer creates the product if its SKU is new, or updates the existing product if the SKU already exists,… How is per-branch stock seeded during import? The third import phase writes BranchStock for every imported product across every chosen branch. What is the "Fetch images" step after import and how does it work safely (SSRF protections)? "Fetch images" is a separate, re-runnable step that reads the image-URL column from your catalogue and downloads each image, processes it, and links it to the product. What does the "delete everything & start fresh" reset do, and what guards protect it? The reset (on the wizard's Welcome step, and also available as a standalone admin tool) wipes all data and configuration to return the deployment to a clean state. What database does Okommerce use and how is it provisioned (schema script vs auto-migrate)? Okommerce uses Microsoft SQL Server (2022) via Entity Framework Core 9. What is the recommended production deployment topology? A typical production deployment is the ASP.NET Core 9 application hosted on a web server (for example Windows Server with IIS, or a Linux host) with the .NET 9 runtime, connected to a SQL Server… What are the server prerequisites to self-host Okommerce? At minimum: a server that can run the .NET 9 runtime (Windows with IIS, or a Linux host), access to a SQL Server 2022 instance (local or networked), and a writable storage location for…