1. Docs
2. Send Data to Honeycomb
3. Honeycomb Telemetry Pipeline
4. Install Honeycomb Telemetry Pipeline

Install Honeycomb Telemetry Pipeline

Ent+

In this guide you’ll install and run the Honeycomb Telemetry Pipeline on Kubernetes using Helm. For installation in other environments, contact your Honeycomb account team for assistance.

Before You Begin 

To install Honeycomb Telemetry Pipeline you’ll need:

• A Honeycomb license key.

Install with Kubernetes Using Helm 

Using the helm chart to install Honeycomb Telemetry Pipeline in a Kubernetes cluster requires Helm 3.0+ and Kubernetes 1.24+.

1. Add the Honeycomb Helm repository:

   helm repo add honeycomb https://honeycombio.github.io/helm-charts
   

2. Set the LICENSE_KEY environment variable to your HTP License key as provided by your Honeycomb account team:

   export LICENSE_KEY="my-honeycomb-license-key"
   

3. Create a Kubernetes secret called hny-secrets, setting the values for username and password to something of your choosing (admin/admin is not recommended):

   kubectl create secret generic hny-secrets \
       --from-literal=license=$LICENSE_KEY \
       --from-literal=sessions_secret=$(uuidgen) \
       --from-literal=username=admin \
       --from-literal=password=admin
   

4. Install the HTP server:

   helm install htp honeycomb/htp
   

5. Add port forwarding to view the UI:

   kubectl port-forward svc/htp 3001
   

Log in and Get Started 

1. In your browser, navigate to localhost:3001 or the remote URL you set during configuration.
2. You should see the Honeycomb logo and a sign in form. Sign in with the username and password from your helm chart. The default value for both fields if you did not change them is admin.
3. Next you should see a Welcome modal with the Honeycomb logo.
4. Enter your desired Organization Name.
5. Read and accept the EULA.