Prerequisites - AspFox

Required software

Software	Minimum version	Where to get it
.NET SDK	8.0	dotnet.microsoft.com/download
Node.js	20	nodejs.org
Docker Desktop	Latest stable	docker.com/products/docker-desktop
Git	Any	git-scm.com
make	Any	See Windows note below

Windows: installing makeWindows does not include make by default. Install it via Chocolatey:

choco install make

Or via Scoop:

scoop install make

Alternatively, open the Makefile and run the underlying docker compose commands directly — the Makefile has comments showing the full command for each target.

External services

These services are used by AspFox. All have free tiers sufficient for local development.

Service	Required for	Free tier
Stripe	Billing features	Yes — test mode is fully free
Resend	Transactional email	Yes — 100 emails/day
Google Cloud Console	Google OAuth	Yes
GitHub OAuth Apps	GitHub OAuth	Yes

Stripe and Resend are optional for initial local development. The application starts and runs without them. Auth, multi-tenancy, and RBAC all work fully. Billing endpoints will return configuration errors, and emails will not send, but you can develop and test everything else without these services configured.

Verify your setup

Run these commands to confirm the required tools are installed:

dotnet --version    # Should print 8.0.x or higher
node --version      # Should print v20.x or higher
docker --version    # Should print Docker version 24.x or higher
docker compose version  # Should print v2.x
make --version      # Should print GNU Make 4.x

If any of these fail, install the missing tool before proceeding to the quickstart.

Quickstart Project Structure

​Required software

​External services

​Verify your setup

Required software

External services

Verify your setup