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

# Quickstart

> Run KeinSaaS Navigator with one model provider and a local database.

This path gets Navigator running locally with `pnpm`, PostgreSQL, and one AI provider key.

<Info>
  You only need one provider key to start. OpenAI, Anthropic, Google Gemini, xAI, OpenRouter, or an Ollama-compatible endpoint can be added later.
</Info>

<Steps>
  <Step title="Install dependencies">
    ```bash theme={null}
    pnpm i
    ```

    The install step runs the project setup script and prepares a `.env` file from the example configuration.
  </Step>

  <Step title="Start PostgreSQL">
    ```bash theme={null}
    pnpm docker:pg
    ```

    If you already have PostgreSQL, keep it running and set `POSTGRES_URL` in `.env` instead.
  </Step>

  <Step title="Add credentials">
    Open `.env` and fill in:

    ```dotenv theme={null}
    BETTER_AUTH_SECRET=your-generated-secret
    POSTGRES_URL=postgres://your_username:your_password@localhost:5432/your_database_name
    OPENAI_API_KEY=sk-...
    ```

    Swap `OPENAI_API_KEY` for another provider if your deployment uses Anthropic, Google, xAI, OpenRouter, or Ollama.
  </Step>

  <Step title="Apply database migrations">
    ```bash theme={null}
    pnpm db:migrate
    ```
  </Step>

  <Step title="Run the app">
    ```bash theme={null}
    pnpm dev
    ```

    Open `http://localhost:3000` and start your first thread.
  </Step>
</Steps>

## First things to try

<CardGroup cols={2}>
  <Card title="Mention a tool" icon="at" href="/features/quick-mentions">
    Type `@` in chat and pick an available tool, workflow, preset, or agent.
  </Card>

  <Card title="Switch tool mode" icon="sliders" href="/features/tool-choice-mode">
    Use automatic, manual, or disabled tool execution depending on the task.
  </Card>

  <Card title="Add web search" icon="globe" href="/features/web-search">
    Add `EXA_API_KEY` to let Navigator research and extract web content.
  </Card>

  <Card title="Connect MCP" icon="plug" href="/guides/mcp-server-setup">
    Register an MCP server and test its tools from the Navigator interface.
  </Card>
</CardGroup>

## Docker shortcut

If you prefer the bundled Docker Compose path:

```bash theme={null}
pnpm i
pnpm docker-compose:up
```

Then fill the generated `.env` with provider keys and open `http://localhost:3000`.