> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aspfox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prerequisites

> Everything you need installed before running the quickstart.

## Required software

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

<Tip>
  **Windows: installing `make`**

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

  ```powershell theme={null}
  choco install make
  ```

  Or via Scoop:

  ```powershell theme={null}
  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.
</Tip>

## External services

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

| Service                                                     | Required for        | Free tier                     |
| ----------------------------------------------------------- | ------------------- | ----------------------------- |
| [Stripe](https://stripe.com)                                | Billing features    | Yes — test mode is fully free |
| [Resend](https://resend.com)                                | Transactional email | Yes — 100 emails/day          |
| [Google Cloud Console](https://console.cloud.google.com)    | Google OAuth        | Yes                           |
| [GitHub OAuth Apps](https://github.com/settings/developers) | GitHub OAuth        | Yes                           |

<Note>
  **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.
</Note>

## Verify your setup

Run these commands to confirm the required tools are installed:

```bash theme={null}
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.