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

# Quickstart

> Configure a provider, worker, and project after installing LStack.

This guide outlines the path from a running LStack dashboard to a project that can execute tickets.

## Prerequisites

Before you begin:

* Install and start LStack.
* Start Docker if you want to create workers or use container-based project runtimes.
* Make sure a compatible model endpoint is reachable from Docker containers.
* Open the dashboard with `lstack open`.

## Configure LStack

<Steps>
  <Step title="Add a provider">
    Open **Providers**, create a provider for your model endpoint, add its authentication details, and validate the connection.
  </Step>

  <Step title="Prepare the worker image">
    Follow the dashboard's first-run guidance to build the managed worker image before creating your first worker.
  </Step>

  <Step title="Create a worker">
    Open **Workers**, select the provider, choose a worker policy, and create the worker. Wait for it to report as available.
  </Step>

  <Step title="Create a project">
    Open **All projects**, create a project, and select or create its workspace folder on the host computer.
  </Step>

  <Step title="Configure worker access">
    Choose which workers the project may use. A ticket can run only when an eligible worker is available to that project.
  </Step>

  <Step title="Create a ticket">
    Add a ticket to the board with a clear objective, then move it into the runnable workflow. Follow its execution status and session output from the dashboard.
  </Step>
</Steps>

## Verify the installation

Use the CLI to confirm that the core is healthy:

```bash theme={null}
lstack status
lstack doctor
```

If the dashboard works but worker actions are unavailable, check that Docker is running and that the worker image has been built.

<Columns cols={2}>
  <Card title="Dashboard overview" icon="layout-dashboard" href="/dashboard/overview">
    Learn where the main product surfaces live.
  </Card>

  <Card title="Diagnostics" icon="stethoscope" href="/operations/diagnostics">
    Diagnose startup, Docker, configuration, and database issues.
  </Card>
</Columns>
