Configuration

Konnect is designed to be configured entirely through its web UI. There are no environment variables or .env files required.

LLM providers

All LLM API keys are entered directly in the Konnect chat interface — no environment variables needed.

Supported providers:

Provider	Notes
Groq	Free tier available — recommended for getting started
OpenAI	GPT-4o and other models
Anthropic	Claude models
Ollama	Self-hosted, no API key needed

To configure your provider:

Open the Chat panel in the Konnect sidebar.
Enter your API key when prompted, or switch providers at any time from the chat settings.

Tip: You only need one provider to get started. You can add more later and switch between them freely.

Docker setup

Konnect runs as a single Docker container with no external configuration files required.

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

Parameter	Description
`-p 7080:7080`	Maps port 7080 on your machine to the application
`-v konnect_data:/app/data`	Persists dashboards, chat history, and settings across restarts

Data connections

All data source connections — SQL databases, MQTT brokers, and OPC-UA servers — are configured through the Konnect web UI.

SQL databases — Add via the Data Sources page (PostgreSQL, MySQL, SQL Server, SQLite, DuckDB)
MQTT brokers — Add via the MQTT page, including Sparkplug B support
OPC-UA servers — Add via the OPC-UA page, browse tag address spaces

See the Data Sources guide for step-by-step instructions.

Application defaults

Setting	Default	Description
Port	`7080`	The application listens on port 7080 inside the container
Data volume	`/app/data`	Where persistent data is stored (mount this as a Docker volume)

Next steps

System Requirements → — Hardware and software prerequisites.
Troubleshooting & FAQ → — Common issues and solutions.