For more information about this image and its history, please see the relevant manifest file (library/chronograf
). This image is updated via pull requests to the docker-library/official-images
GitHub repo.
For detailed information about the virtual/transfer sizes and individual layers of each of the above supported tags, please see the chronograf/tag-details.md
file in the docker-library/docs
GitHub repo.
Chronograf is a simple to install graphing and visualization application that you deploy behind your firewall to perform ad-hoc exploration of your InfluxDB data. It includes support for templates and a library of intelligent, pre-configured dashboards for common data sets.
By default, Chronograf listens on port 10000
and stores its data in a volume at /var/lib/chronograf
. You can start an instance with:
$ docker run -p 10000:10000 chronograf
You can also use a custom configuration file or environment variables to modify Chronograf settings.
A sample configuration file can be obtained by:
$ docker run --rm chronograf -sample-config > chronograf.conf
Once you've customized chronograf.conf
, you can run the Chronograf container with it mounted in the expected location (note the name change!):
$ docker run -p 10000:10000 \
-v $PWD/chronograf.conf:/etc/chronograf/chronograf.conf:ro
Modify $PWD
to the directory where you want to store the configuration file.
You may have noticed that the default Bind
value in the configuration is set to 127.0.0.1:10000
, though the container will listen on 0.0.0.0:10000
instead. This is due to a default configuration file being provided inside of the image. You can override values inside of the configuration file using environment variables following the CamelCase
to CHRONOGRAF_CAMEL_CASE
pattern:
SETTING | ENV VAR |
---|---|
Bind | CHRONOGRAF_BIND |
LocalDatabase | CHRONOGRAF_LOCAL_DATABASE |
QueryResponseBytesLimit | CHRONOGRAF_QUERY_RESPONSE_BYTES_LIMIT |
See the official docs for information on creating visualizations.
View license information for the software contained in this image.
This image is officially supported on Docker version 1.11.2.
Support for older versions (down to 1.6) is provided on a best-effort basis.
Please see the Docker installation documentation for details on how to upgrade your Docker daemon.
Documentation for this image is stored in the chronograf/
directory of the docker-library/docs
GitHub repo. Be sure to familiarize yourself with the repository's README.md
file before attempting a pull request.
If you have any problems with or questions about this image, please contact us through a GitHub issue. If the issue is related to a CVE, please check for a cve-tracker
issue on the official-images
repository first.
You can also reach many of the official image maintainers via the #docker-library
IRC channel on Freenode.
You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.
Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.