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.

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.

1. Create your account

   Go to cloud.Hadiq.io and sign up with your email or Google account.

   Once you confirm your email, you’ll land in your Hadiq.io workspace.

2. 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.

   Start with a single connector for a focused first experience. You can add more sources at any time from Admin → Connectors.

3. 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.

   Results reflect only documents you have access to in the connected source. Permissions sync automatically from the connector.

4. 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

Self-hosted

Self-host Hadiq.io on any machine with Docker. The single-command installer handles the full setup.

1. Check prerequisites

   Before you begin, make sure you have the following installed:

   • 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

   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 for details.

2. Run the installer

   Run the following command in your terminal:

   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.

   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.

3. 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.

4. 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.

Managing your deployment

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

./install.sh --shutdown

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

./install.sh --shutdown
curl -fsSL https://Hadiq.io.app/install_Hadiq.io.sh | bash

What to do next

Add more connectors

Index more of your team’s knowledge from Slack, GitHub, Notion, and 40+ other sources.

Build a custom agent

Create an agent with specific instructions and a curated knowledge base for your team’s workflows.

Set up the Slack bot

Let your team ask Hadiq.io questions directly from Slack.

Invite your team

Add teammates, assign roles, and configure access controls.