Install Kapacitor

This page provides directions for installing, starting, and configuring Kapacitor.


Installation of the InfluxDB package may require root or administrator privileges in order to complete successfully.

Platform support

Kapacitor 1.6+ no longer supports 32-bit operating systems. If you are using a 32-bit operating system, continue using Kapacitor 1.5.x.

Builds have been provided for ARM 64-bit architectures.


Kapacitor listens on TCP port 9092 for all API and write calls.

Kapacitor may also bind to randomized UDP ports for handling of InfluxDB data via subscriptions.


Kapacitor has two binaries:

  • kapacitor: a CLI program for calling the Kapacitor API.
  • kapacitord: the Kapacitor server daemon.

You can download the binaries directly from the downloads page.

Note: Windows support is experimental.

Starting the Kapacitor service

For packaged installations, please see the respective sections below for your operating system. For non-packaged installations (tarballs or from source), you will need to start the Kapacitor application manually by running:

./kapacitord -config <PATH TO CONFIGURATION>

macOS (using Homebrew)

To have launchd start Kapacitor at login:

ln -sfv /usr/local/opt/kapacitor/*.plist ~/Library/LaunchAgents

Then to load Kapacitor now:

launchctl load ~/Library/LaunchAgents/homebrew.mxcl.kapacitor.plist

Or, if you don’t want or need launchctl, you can just run:

kapacitord -config /usr/local/etc/kapacitor.conf

Linux - SysV or Upstart systems

To start the Kapacitor service, run:

sudo service kapacitor start

Linux - systemd systems

To start the Kapacitor service, run:

sudo systemctl start kapacitor


An example configuration file can be found here.

Kapacitor can also provide an example configuration for you using this command:

kapacitord config

To generate a new configuration file, run:

kapacitord config > kapacitor.generated.conf

Shared secret

If using Kapacitor v1.5.3 or newer and InfluxDB with authentication enabled, set the [http].shared-secret option in your Kapacitor configuration file to the shared secret of your InfluxDB instances.

# ...
  # ...
  shared-secret = "youramazingsharedsecret"

If not set, set to an empty string, or does not match InfluxDB’s shared-secret, the integration with InfluxDB will fail and Kapacitor will not start.

Time zone

To display alerts notifications using a preferred time zone, either change the time zone of the host on which Kapacitor is running or set the Kapacitor process’ TZ environment variable.


Add the environment variable using systemctl edit kapacitor:



Set the environment variable using the -e flag when starting the container (-e TZ=Asia/Shanghai) or in your docker-compose.yml.

Was this page helpful?

Thank you for your feedback!

Introducing InfluxDB Clustered

A highly available InfluxDB 3.0 cluster on your own infrastructure.

InfluxDB Clustered is a highly available InfluxDB 3.0 cluster built for high write and query workloads on your own infrastructure.

InfluxDB Clustered is currently in limited availability and is only available to a limited group of InfluxData customers. If interested in being part of the limited access group, please contact the InfluxData Sales team.

Learn more
Contact InfluxData Sales

The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following: