# Install the Agent Through Install Hub
When you create a cluster, you'll be taken to the
Install Hub page for the cluster. To install the Insights Agent:
- Decide which reports you would like to run in your cluster
- Hover over each of the desired reports, then click the
Quick Addbutton at the bottom of the report
- Click the
Ready to Installicon located in the top right corner of the page
Follow the instructions to install the Insights Agent with Helm. If you'd like to view the Kubernetes
manifests first, you can use
helm template to generate the YAML files.
# Fleet Installation
To better serve customers with a large number of clusters, we've created a flow that allows you to easily deploy the Insights Agent across your fleet.
You can use the following commands to install the insights-agent in many clusters,
insights.cluster to a unique identifier for each cluster (e.g. generated using
your kube context).
kubectl delete job --all -n insights-agent helm upgrade --install insights-agent fairwinds-stable/insights-agent \ --namespace insights-agent \ --create-namespace \ --set fleetInstall=true \ --set insights.organization="$YOUR_ORGANIZATION" \ --set insights.cluster="$CLUSTER_IDENTIFIER" \ --set insights.tokenSecretName=insights-token \ --set insights.apiToken="$YOUR_API_TOKEN"
With these flags set, the Helm chart will create a new cluster in the Insights UI with the specified name (unless a cluster with that name already exists) before installing the agent.
Here's a description of the flags above:
fleetInstall- Boolean - specify if this install is using the fleet install flow
insights.organization- String - the name your organization in Insights
insights.cluster- String - the name you want to give this cluster in the Insights UI. You may want to auto-generate this from your kubectl context
insights.tokenSecretName- String - the name of the secret where Insights will store your cluster's token. We recommend
insights.apiToken- String - the admin token from your organization's
Settings > Tokenspage
You'll also want to set
$report.enabled for each of the reports you want to run,
as well as any other chart options (opens new window)
Here is an example of installing the Insights Agent with the
Trivy reports inside a cluster named
test-cluster within the
kubectl delete job --all -n insights-agent helm upgrade --install insights-agent fairwinds-stable/insights-agent \ --namespace insights-agent \ --create-namespace \ --set fleetInstall=true \ --set insights.organization="test-org" \ --set insights.cluster="test-cluster" \ --set insights.tokenSecretName=insights-token \ --set insights.apiToken="thisIsTheTestOrgAdminToken1234567"
When reinstalling the Agent in the same cluster, you can omit
and simply specify
This allows you to hand off control of the Agent to other teams without sharing your
← About Troubleshooting →