---
title: Install Chronograf
description: Download and install Chronograf.
menu:
  chronograf_1_9:
    name: Install
    weight: 20
    parent: Introduction
---

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://portal.influxdata.com/downloads).

1. Choose the download link for your operating system.

    {{% 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.
    {{% /note %}}

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

    {{% tabs-wrapper %}}
    {{% tabs %}}
[macOS](#)
[Ubuntu & Debian](#)
[RedHat & CentOS](#)
    {{% /tabs %}}
    {{% tab-content %}}
```sh
tar zxvf chronograf-<version#>_darwin_amd64.tar.gz
```
    {{% /tab-content %}}

    {{% tab-content %}}
```sh
sudo dpkg -i chronograf_<version#>_amd64.deb
```
    {{% /tab-content %}}

    {{% tab-content %}}
```sh
sudo yum localinstall chronograf-<version#>.x86_64.rpm
```
    {{% /tab-content %}}
    {{% /tabs-wrapper %}}

3. Start Chronograf:

    ```sh
    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](/{{< latest "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.9/administration/managing-influxdb-users/)
and [manage Chronograf users](/chronograf/v1.9/administration/managing-chronograf-users/).
      {{% /note %}}

    - **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**.