bitzorcas
中 EN

Guide

Prerequisites

What you need installed locally before running a BitzOrcas.Modern project.

Last updated

A short checklist. The rest of Getting Started assumes these are in place.

Required

  • .NET 10 SDK — from dotnet.microsoft.com/download. The repo’s global.json pins SDK 10.0.201 (rolling forward to the latest feature band).
  • Docker — used for SQL Server and RabbitMQ containers (Aspire provisions both, and the integration tests rely on them). Docker Desktop on macOS / Windows, Docker Engine on Linux.
  • Git — for cloning the repo.

No separate Aspire install is needed: the AppHost project pulls the Aspire SDK (Aspire.AppHost.Sdk) from NuGet during restore.

Optional

  • SQL Server — install locally only if you’d rather not run SQL Server in a container. Otherwise Aspire provisions one for you. The template targets SQL Server as its primary database; SqlSugar also supports MySQL, PostgreSQL, and SQLite via its own provider model.
  • RabbitMQ Management — Aspire provisions a RabbitMQ container. If you want to inspect queues manually, the management UI is available at http://localhost:15672 (guest/guest by default).

Verify

Terminal window
dotnet --version       # 10.x.x
docker info            # should print server info, not error
git --version

If dotnet --version reports 9.x or older, install the .NET 10 SDK before continuing — the template targets net10.0 and won’t build on earlier SDKs.

Next

Quick Start → clone the repo and run it.