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

# Getting Started

# Getting Started

Goal: go from zero to a first working chat with minimal setup.

<Info>
  Fastest chat: open the Control UI (no channel setup needed). Run `datzi
      dashboard` and chat in the browser, or open `http://127.0.0.1:18789/` on the
  <Tooltip>gateway host</Tooltip>. Docs: Dashboard and Control UI.
</Info>

## Prereqs

* Node 22 or newer

<Tip>Check your Node version with `node --version` if you are unsure.</Tip>

## Quick setup (CLI)

<Steps>
  <Step title="Install Datzi (recommended)">
    <Tabs>
      <Tab title="macOS/Linux">
        ```bash theme={null}
        curl -fsSL https://datzi.ai/install.sh | bash
        ```

        <img alt="Install Script Process" />
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={null}
        iwr -useb https://datzi.ai/install.ps1 | iex
        ```
      </Tab>
    </Tabs>

    <Note>
      Other install methods and requirements: [Install](/datzi/install/index).
    </Note>
  </Step>

  <Step title="Run the onboarding wizard">
    ```bash theme={null}
    datzi onboard --install-daemon
    ```

    The wizard configures auth, gateway settings, and optional channels.
    See [Onboarding Wizard](/datzi/start/wizard) for details.
  </Step>

  <Step title="Check the Gateway">
    If you installed the service, it should already be running:

    ```bash theme={null}
    datzi gateway status
    ```
  </Step>

  <Step title="Open the Control UI">
    ```bash theme={null}
    datzi dashboard
    ```
  </Step>
</Steps>

<Check>If the Control UI loads, your Gateway is ready for use.</Check>

## Optional checks and extras

<AccordionGroup>
  <Accordion title="Run the Gateway in the foreground">
    Useful for quick tests or troubleshooting.

    ```bash theme={null}
    datzi gateway --port 18789
    ```
  </Accordion>

  <Accordion title="Send a test message">
    Requires a configured channel.

    ```bash theme={null}
    datzi message send --target +15555550123 --message "Hello from Datzi"
    ```
  </Accordion>
</AccordionGroup>

## Useful environment variables

If you run Datzi as a service account or want custom config/state locations:

* `DATZI_HOME` sets the home directory used for internal path resolution.
* `DATZI_STATE_DIR` overrides the state directory.
* `DATZI_CONFIG_PATH` overrides the config file path.

Full environment variable reference: [Environment vars](/datzi/help/environment).

## Go deeper

<Columns>
  <Card title="Onboarding Wizard (details)" href="/datzi/start/wizard">
    Full CLI wizard reference and advanced options.
  </Card>

  <Card title="macOS app onboarding" href="/datzi/start/onboarding">
    First run flow for the macOS app.
  </Card>
</Columns>

## What you will have

* A running Gateway
* Auth configured
* Control UI access or a connected channel

## Next steps

* DM safety and approvals: [Pairing](/datzi/channels/pairing)
* Connect more channels: [Channels](/datzi/channels/index)
* Advanced workflows and from source: [Setup](/datzi/start/wizard)