Installation

Get Konnect running on your machine in under 5 minutes using Docker.

---

Prerequisites

Before you begin, make sure you have:

• Docker 24.0 or higher installed (Get Docker)
• 4 GB RAM minimum (8 GB recommended)
• 10 GB free disk space
• An LLM API key from one of the supported providers (Groq, OpenAI, Anthropic, or Ollama). You’ll enter this through the Konnect UI after launching — no environment files needed.

---

Step 1 — Pull the Docker image

Open a terminal and pull the latest Konnect image:

docker pull ghcr.io/kyanitesolutions/konnect:beta-latest

---

Step 2 — Start the container

Run Konnect:

docker run -d \
  --name konnect \
  -p 7080:7080 \
  -v konnect_data:/app/data \
  ghcr.io/kyanitesolutions/konnect:beta-latest

The -v konnect_data:/app/data volume persists your dashboard layouts, chat history, and configuration across container restarts.

---

Step 3 — Open Konnect

Open your browser and navigate to:

http://localhost:7080

You should see the Konnect Manufacturing IDE. If the page doesn’t load immediately, wait 30–60 seconds for the application to finish starting.

---

Step 4 — Configure your LLM provider

Once the UI loads:

1. Open the Chat panel on the left sidebar.
2. Enter your LLM API key when prompted — choose from Groq, OpenAI, Anthropic, or Ollama.
3. You can switch providers at any time from the chat interface.

Tip: Groq offers a free tier with excellent performance — recommended for getting started.

---

Verify the installation

Check that the container is running and healthy:

docker ps --filter name=konnect

You should see the container listed with status Up. You can also check the health endpoint:

curl http://localhost:7080/health

---

Docker Compose (optional)

If you prefer Docker Compose, create a docker-compose.yml:

version: '3.8'
services:
  konnect:
    image: ghcr.io/kyanitesolutions/konnect:beta-latest
    container_name: konnect
    ports:
      - "7080:7080"
    volumes:
      - konnect-data:/app/data
    restart: unless-stopped

volumes:
  konnect-data:

Start with:

docker compose up -d

The konnect-data volume persists your dashboard layouts, chat history, and configuration across container restarts.

---

Updating Konnect

To update to the latest version:

docker pull ghcr.io/kyanitesolutions/konnect:beta-latest
docker stop konnect
docker rm konnect
docker run -d --name konnect -p 7080:7080 -v konnect_data:/app/data ghcr.io/kyanitesolutions/konnect:beta-latest

Your data is preserved in Docker volumes.

---

Next steps

Once Konnect is running, head to First Steps to connect your first data source and ask your first question.