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

# Quickstart

> Get NIL Benchmark running locally in under 5 minutes.

## Prerequisites

* [Docker Desktop](https://www.docker.com/products/docker-desktop/) installed and running
* Git
* Ports 3000, 5432, 8000, 9000, 9001 available

## Steps

<Steps>
  <Step title="Clone the repository">
    ```bash theme={null}
    git clone <your-repo-url> nil && cd nil
    ```
  </Step>

  <Step title="Start all services">
    ```bash theme={null}
    docker compose up --build
    ```

    This starts **4 containers**: PostgreSQL 16 (port 5432), MinIO S3 storage (ports 9000/9001), FastAPI backend (port 8000), and Vite frontend (port 3000). On first run the backend creates tables, seeds 2,320 athletes with 1,852 deals, and uploads placeholder contract PDFs to MinIO.
  </Step>

  <Step title="Open the app">
    Go to [http://localhost:3000](http://localhost:3000) and log in with `admin@bluemountain.edu` / `password123`. You will land on the Dashboard with live KPIs computed from seeded data.
  </Step>
</Steps>

## Resetting Data

```bash theme={null}
docker compose down -v    # Wipe containers + volumes
docker compose up --build # Rebuild and reseed from scratch
```