---
title: Install Chronograf
description: Download and install Chronograf.
url: https://docs.influxdata.com/chronograf/v1/introduction/installation/
estimated_tokens: 829
product: Chronograf
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/chronograf/v1/introduction/installation/
date: '2023-11-14T16:49:35-07:00'
lastmod: '2023-11-14T16:49:35-07:00'
---

This page describes how to download and install Chronograf.

### Content

* [TICK overview](#tick-overview)
* [Download and install](#download-and-install)
* [Connect to your InfluxDB instance or InfluxDB Enterprise cluster](#connect-chronograf-to-your-influxdb-instance-or-influxdb-enterprise-cluster)
* [Connect to Kapacitor](#connect-chronograf-to-kapacitor)

## TICK overview

Chronograf is the user interface for InfluxData’s [TICK stack](https://www.influxdata.com/time-series-platform/).

## Download and install

The latest Chronograf builds are available on InfluxData’s [Downloads page](https://www.influxdata.com/downloads/).

1. On the Downloads page, scroll to the bottom and click **Are you interested in InfluxDB 1.x Open Source?** to expand the 1.x options. Scroll to the **Chronograf** section and select your desired Chronograf version and operating system. Execute the provided download commands.

   > [!Note]
> If your download includes a TAR package, save the underlying datastore `chronograf-v1.db` in directory outside of where you start Chronograf. This preserves and references your existing datastore, including configurations and dashboards, when you download future versions.

2. Install Chronograf, replacing `<version#>` with the appropriate version:

   #### macOS ####

   ```
   tar zxvf chronograf-1.11.3_darwin_amd64.tar.gz
   ```

   ```
   sudo dpkg -i chronograf_1.11.3_amd64.deb
   ```

   ```
   sudo yum localinstall chronograf-1.11.3.x86_64.rpm
   ```

3. Start Chronograf:

   ```
   chronograf
   ```

## Connect Chronograf to your InfluxDB instance or InfluxDB Enterprise cluster

1. In a browser, navigate to [localhost:8888](http://localhost:8888).
2. Provide the following details:
   * **Connection String**: InfluxDB hostname or IP, and port (default port is `8086`).

   * **Connection Name**: Connection name.

   * **Username** and **Password**: If you’ve enabled[InfluxDB authentication](/influxdb/v1/administration/authentication_and_authorization),
     provide your InfluxDB username and password. Otherwise, leave blank.

     > [!Note]
> To ensure distinct permissions can be applied, Chronograf user accounts and
> credentials should be different than InfluxDB credentials.
> For example, you may want to set up Chronograf to run as a service account
> with read-only permissions to InfluxDB. For more information, see how to[manage InfluxDB users in Chronograf](/chronograf/v1/administration/managing-influxdb-users/)and [manage Chronograf users](/chronograf/v1/administration/managing-chronograf-users/).

   * **Telegraf Database Name**: *(Optional)* Telegraf database name.
     Default name is `telegraf`.

3. Click **Add Source**.

## Connect Chronograf to Kapacitor

1. In Chronograf, click the configuration (wrench) icon in the sidebar menu, then select **Add Config** in the **Active Kapacitator** column.
2. In the **Kapacitor URL** field, enter the hostname or IP of the machine that Kapacitor is running on. Be sure to include Kapacitor’s default port: `9092`.
3. Enter a name for your connection.
4. Leave the **Username** and **Password** fields blank unless you’ve specifically enabled authorization in Kapacitor.
5. Click **Connect**.

**Note:** Using [Kapacitor](/kapacitor/v1/) is optional and not required to use Chronograf.