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

# Quickstart

> Use this page as the installation and local-development entrypoint for BlueAccademy.

This page is the entrypoint for the local setup flow. Use the linked pages below in order.

## Self hosted installation path

<Steps>
  <Step title="Install the prerequisites">
    Install Rancher Desktop, and all the developer tools
  </Step>

  <Step title="Start the application">
    Run `docker compose -f infra/docker-compose.yml up --build` from the root of the repo
  </Step>

  <Step title="Use the current application workflow">
    Open `http://localhost:5173` and use the flashcard flow as the current supported end-to-end application path
  </Step>
</Steps>

## Jump directly to

<CardGroup cols={2}>
  <Card title="Rancher Desktop" icon="box" href="/installation/rancher-desktop">
    Install the preferred local container and Kubernetes runtime, then verify `kubectl` and Helm.
  </Card>

  <Card title="Developer tooling" icon="terminal" href="/installation/developer-tooling">
    Install `uv`, Python, and `pre-commit`, then sync the repository and install Git hooks.
  </Card>

  <Card title="Run locally" icon="play" href="/running-locally">
    Start the Compose stack, wait for health checks, and open the app locally.
  </Card>
</CardGroup>