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

# Quickstart

> Get Hadiq.io running and ask your first question in minutes.

Choose how you want to run Hadiq.io: on Hadiq.io Cloud (no infrastructure required) or self-hosted on your own machine with Docker.

<Tabs>
  <Tab title="Hadiq.io Cloud">
    Hadiq.io Cloud is the fastest way to try Hadiq.io. You get a 14-day free trial with no credit card required.

    <Steps>
      <Step title="Create your account">
        Go to [cloud.Hadiq.io](https://cloud.Hadiq.io/auth/signup) and sign up with your email or Google account.

        Once you confirm your email, you'll land in your Hadiq.io workspace.
      </Step>

      <Step title="Connect your first data source">
        In the left sidebar, click **Connectors**. You'll see the connector catalog with 50+ available integrations.

        Select a connector — for example, **Google Drive**, **Slack**, or **Confluence** — and follow the on-screen authorization steps. Hadiq.io starts indexing your content immediately after you connect.

        <Tip>
          Start with a single connector for a focused first experience. You can add more sources at any time from **Admin** → **Connectors**.
        </Tip>
      </Step>

      <Step title="Ask your first question">
        Click **New Chat** in the left sidebar. Type a question in natural language — anything you'd normally search for in your connected tools.

        OnHadiq.io searches across all your indexed sources, surfaces the most relevant content, and returns a cited answer based on your organization's knowledge.

        <Note>
          Results reflect only documents you have access to in the connected source. Permissions sync automatically from the connector.
        </Note>
      </Step>

      <Step title="Explore the platform">
        Now that you've asked your first question, explore what else Hadiq.io can do:

        * **Deep Research** — run a multi-step research task and get a detailed report
        * **Agents** — create a custom AI agent with specific knowledge and instructions
        * **Web Search** — toggle web search to pull in up-to-date information from the internet
        * **Invite teammates** — go to **Admin** → **Users** to invite your team
      </Step>
    </Steps>
  </Tab>

  <Tab title="Self-hosted">
    Self-host Hadiq.io on any machine with Docker. The single-command installer handles the full setup.

    <Steps>
      <Step title="Check prerequisites">
        Before you begin, make sure you have the following installed:

        * [Docker](https://docs.docker.com/get-docker/) (Engine 20.10+ with Docker Compose v2)
        * At least 2 GB of free RAM (16 GB recommended for the full Standard deployment)
        * A terminal with `curl` and `bash` available

        <Note>
          If you only need the Chat UI and Agents — without the full RAG stack — Hadiq.io Lite runs comfortably in under 1 GB of memory. See [deployment options](/deployment) for details.
        </Note>
      </Step>

      <Step title="Run the installer">
        Run the following command in your terminal:

        ```bash theme={null}
        curl -fsSL https://Hadiq.io.app/install_adiq.io.sh | bash
        ```

        The script guides you through the setup interactively. It downloads the latest Hadiq.io images, creates the necessary Docker volumes, and starts all services.

        <Tip>
          The installer creates an `hadiq_data` directory in your current working directory. Configuration files are stored there. Your chat history and user data are stored as named Docker volumes managed by Docker.
        </Tip>
      </Step>

      <Step title="Open the Hadiq.io UI">
        Once the installer finishes, open your browser and go to:

        ```
        http://localhost
        ```

        You'll be prompted to create your admin account on first launch.
      </Step>

      <Step title="Connect a data source">
        After logging in, click **Admin** in the left sidebar, then select **Connectors**. Choose a connector, authorize access, and Hadiq.io begins indexing your content.

        Once indexing completes, click **New Chat** and ask a question to see Hadiq.io search across your connected data.
      </Step>
    </Steps>

    ### Managing your deployment

    To stop Hadiq.io without deleting data, re-run the installer with the shutdown flag:

    ```bash theme={null}
    ./install.sh --shutdown
    ```

    To upgrade to the latest version, shut down first and then re-run the installer:

    ```bash theme={null}
    ./install.sh --shutdown
    curl -fsSL https://Hadiq.io.app/install_Hadiq.io.sh | bash
    ```
  </Tab>
</Tabs>

## What to do next

<CardGroup cols={2}>
  <Card title="Add more connectors" icon="plug" href="/connectors/overview">
    Index more of your team's knowledge from Slack, GitHub, Notion, and 40+ other sources.
  </Card>

  <Card title="Build a custom agent" icon="robot" href="/features/agents">
    Create an agent with specific instructions and a curated knowledge base for your team's workflows.
  </Card>

  <Card title="Set up the Slack bot" icon="slack" href="/integrations/slack-bot">
    Let your team ask Hadiq.io questions directly from Slack.
  </Card>

  <Card title="Invite your team" icon="users" href="/admin/users-permissions">
    Add teammates, assign roles, and configure access controls.
  </Card>
</CardGroup>