---
title: Run the Polaris suite locally
description: Start Flagpole, exercise Drift, and serve this documentation from sibling repositories.
url: https://pr-15-c0fdf0ef9f59.thally.app/guides/create-a-site
---

# Run the Polaris suite locally

Start Flagpole, exercise Drift, and serve this documentation from sibling repositories.

Use separate sibling directories so each product keeps its own dependencies,
tests, and Git history. You need Git and Node.js 20 or later to run the complete
suite.

#### Clone the repositories

    ```bash
    mkdir polaris-labs && cd polaris-labs
    git clone https://github.com/kenny-io/flagpole-api.git
    git clone https://github.com/kenny-io/driftkv.git
    git clone https://github.com/thallylabs/polaris-labs-docs.git
    ```

#### Start Flagpole

    ```bash
    cd flagpole-api
    npm install
    npm run dev
    ```

    Verify `http://localhost:3333/health` returns status `ok` and version
    `1.1.0`.

#### Verify Drift

    In another terminal:

    ```bash
    cd polaris-labs/driftkv
    npm install
    npm test
    ```

    The test suite exercises TTLs, LRU order, namespaces, events, snapshots,
    batches, and transactions without starting a server.

#### Serve the documentation

    ```bash
    cd polaris-labs/polaris-labs-docs
    npm install
    npm run dev
    ```

    Open `http://localhost:3040` and complete both product quickstarts.

The repositories are intentionally independent: Flagpole is a service, Drift
is an npm package, and this site is their reviewed documentation surface.