> For the complete documentation index, see [llms.txt](https://docs.cybus.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cybus.io/2-4-1/documentation/agents/agents-in-kubernetes.md).

# Agents with the connectware-agent Helm Chart

The `connectware-agent` Helm chart deploys and manages Connectware agents independently from your main Connectware installation. This allows you to:

* Deploy agents on infrastructure closer to your shop floor or data sources
* Maintain granular control over deployment groups
* Run agents in separate Kubernetes clusters or namespaces

{% hint style="info" %}
Agents can be deployed as a standalone Helm release or as part of your Connectware installation using the `connectware-agent` chart as a subchart.
{% endhint %}

## Installation Methods

Choose one of the following methods to deploy agents:

1. **Standalone Helm release**: Deploy agents independently with their own Helm release. See [Installing Connectware Agents Using the connectware-agent Helm Chart](/2-4-1/documentation/agents/agents-in-kubernetes/installing-connectware-agents-using-the-connectware-agent-helm-chart.md).
2. **Within Connectware installation**: Deploy agents as part of your connectware Helm chart. See [Deploying Agents with Your Connectware Installation](/2-4-1/documentation/agents/agents-in-kubernetes/deploying-agents-with-your-connectware-installation.md).

{% hint style="info" %}
Before installing agents, review the [Kubernetes cluster requirements for the connectware-agent Helm chart](/2-4-1/getting-started/system-requirements.md#agents-on-kubernetes) to ensure your cluster meets all prerequisites.
{% endhint %}

## Configuring and Managing Agents

Once deployed, use the following resources to configure and manage your agents:

* [Configuration principles for the connectware-agent Helm chart](/2-4-1/cybus-helm-charts/connectware-agent-helm-chart.md#configuration-principles-for-the-connectware-agent-helm-chart) - Understand how to structure your configuration
* [Configuring agents with the connectware-agent Helm chart](/2-4-1/cybus-helm-charts/connectware-agent-helm-chart.md) - Complete configuration reference
* [Upgrading the connectware-agent Helm chart](/2-4-1/documentation/agents/agents-in-kubernetes/upgrading-the-connectware-agent-helm-chart.md) - Upgrade procedures and best practices
* [Uninstalling Connectware agents with the connectware-agent Helm chart](/2-4-1/documentation/agents/agents-in-kubernetes/uninstalling-connectware-agents-with-the-connectware-agent-helm-chart.md) - Clean removal procedures
* [Helm Value Reference](/2-4-1/reference/helm-chart-reference.md#connectware-agent-helm-chart-values-reference) - Complete Helm values reference

## Troubleshooting

For troubleshooting common issues with agents, see:

* [Troubleshooting Agents](/2-4-1/documentation/agents/troubleshooting-agents.md)
* [Troubleshooting on Kubernetes](/2-4-1/cybus-helm-charts/troubleshooting-on-kubernetes.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cybus.io/2-4-1/documentation/agents/agents-in-kubernetes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.