Getting Started

Learn how to install and configure Conduit to query your industrial data in minutes.

Getting Started with Conduit

Welcome to Conduit! This guide will help you get up and running with the Industrial Context Mesh in under 30 minutes.

Prerequisites

Before you begin, ensure you have the following:

  • Docker (version 20.10 or later) or a compatible container runtime
  • Network access to your data sources (historians, SCADA systems)
  • Basic familiarity with your industrial data infrastructure

Quick Start

Step 1: Pull the Conduit Image

docker pull conduit/conduit:latest

Step 2: Start Conduit

Run Conduit with the default configuration:

docker run -d \
  --name conduit \
  -p 8080:8080 \
  -p 5432:5432 \
  conduit/conduit:latest

This starts Conduit with:

  • Web UI on port 8080
  • PostgreSQL (context store) on port 5432

Step 3: Access the Dashboard

Open your browser and navigate to http://localhost:8080. You should see the Conduit dashboard.

Configure Your First Adapter

Adapters connect Conduit to your data sources. Let's configure an OPC-UA adapter as an example.

Add an OPC-UA Adapter

  1. In the dashboard, navigate to Settings > Adapters
  2. Click Add Adapter
  3. Select OPC-UA from the list
  4. Enter your OPC-UA server details:
adapter:
  type: opcua
  name: production-line-1
  endpoint: opc.tcp://192.168.1.100:4840
  security:
    mode: SignAndEncrypt
    policy: Basic256Sha256
  1. Click Test Connection to verify connectivity
  2. Click Save to activate the adapter

Your First Query

Now that you have an adapter configured, let's run your first query using NQE (Natural Query English).

Using the Query Interface

  1. Navigate to Query in the dashboard
  2. Type a natural language question:
What is the current temperature of Tank 1?
  1. Press Enter or click Run

Conduit will:

  1. Interpret your natural language query with AI
  2. Generate a structured query for your review
  3. Execute the query against your connected adapters
  4. Return the results

Example Response

{
  "query": "What is the current temperature of Tank 1?",
  "nqe": "Show current value, where tag is Tank1_Temperature",
  "results": [
    {
      "tag": "Tank1_Temperature",
      "value": 72.5,
      "unit": "F",
      "timestamp": "2026-01-21T10:30:00Z"
    }
  ]
}

Next Steps

Now that you have Conduit running, explore these resources:

  • Concepts - Understand the architecture and key concepts
  • Adapters - Configure connections to Ignition, PI, and more
  • NQE Guide - Master natural language queries
  • API Reference - Build integrations with the REST API

Getting Help

  • Documentation: You're here!
  • GitHub Issues: Report bugs or request features
  • Community Discord: Join the conversation
  • Enterprise Support: Contact sales for dedicated support

Ready to dive deeper? Check out the Concepts guide to understand how Conduit's context mesh works.