docs-v2/content/chronograf/v1.8/introduction/installation.md

---
title: Install Chronograf
description: Download and install Chronograf.
menu:
  chronograf_1_8:
    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. Point your web browser to [localhost:8888](http://localhost:8888).
2. Fill out the form with the following details:
  * **Connection String**: Enter the hostname or IP of the machine that InfluxDB is running on, and be sure to include InfluxDB's default port `8086`.
  * **Connection Name**: Enter a name for your connection string.
  * **Username** and **Password**: These fields can remain blank unless you've [enabled authentication](/influxdb/v1.8/administration/authentication_and_authorization.md) in InfluxDB.
  * **Telegraf Database Name**: Optionally, enter a name for your Telegraf database. The 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**.