📊 Dockerized Grafana 5.x/4.x/3.x with all preinstalled (community) plugins from grafana.net
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Grafana XXL

DockerHub pulls GitHub stars DockerHub stars Commercial support ready

Dockerized Grafana with all preinstalled plugins from https://grafana.net/plugins.

Grafana XXL datasources and plugins

Please donate to author, so he can continue to publish another awesome projects for free:

Paypal donate button

Running your Grafana XXL Docker image

Start your image binding the external port 3000:

docker run -d --name=grafana-xxl -p 3000:3000 monitoringartist/grafana-xxl:latest

Try it out, default admin user is admin/admin.

Grafana XXL with persistent storage (recommended)

# create /var/lib/grafana as persistent volume storage
docker run -d -v /var/lib/grafana --name grafana-xxl-storage busybox:latest

# start grafana-xxl
docker run \
  -d \
  -p 3000:3000 \
  --name grafana-xxl \
  --volumes-from grafana-xxl-storage \

Running specific version of Grafana XXL

# specify right tag, e.g. 2.6,3.1,dev (latest nigthly build) - see Docker Hub for available tags
docker run \
  -d \
  -p 3000:3000 \
  --name grafana-xxl \

Building Grafana XXL for ARM

You need ARM-version Grafana's deb (for example from here). Also you need ARM-version of gosu (from here)

# armhf
docker build \
  --tag grafana-xxl \
  --build-arg GRAFANA_DEB_URL=https://github.com/fg2it/grafana-on-raspberry/releases/download/v5.0.4/grafana_5.0.4_armhf.deb \
  --build-arg GOSU_BIN_URL=https://github.com/tianon/gosu/releases/download/1.10/gosu-armhf .

# arm64
docker build \
  --tag grafana-xxl \
  --build-arg GRAFANA_DEB_URL=https://github.com/fg2it/grafana-on-raspberry/releases/download/v5.0.4/grafana_5.0.4_arm64.deb \
  --build-arg GOSU_BIN_URL=https://github.com/tianon/gosu/releases/download/1.10/gosu-arm64 .

Configuring your Grafana container

All options defined in conf/grafana.ini can be overriden using environment variables by using the syntax GF__. For example:

docker run \
  -d \
  -p 3000:3000 \
  --name=grafana-xxl \
  -e "GF_SERVER_ROOT_URL=http://grafana.server.name" \

More information in the grafana configuration documentation: http://docs.grafana.org/installation/configuration/

Configuring AWS credentials for CloudWatch support (only Grafana 3.+)

docker run \
  -d \
  -p 3000:3000 \
  --name=grafana-xxl \
  -e "GF_AWS_PROFILES=default" \
  -e "GF_AWS_default_REGION=eu-west-1" \

You may also specify multiple profiles to GF_AWS_PROFILES (e.g. GF_AWS_PROFILES=default another).

Supported variables:

  • GF_AWS_PROFILES: list of AWS profiles for Cloudwatch datasource
  • GF_AWS_${profile}_ACCESS_KEY_ID: AWS access key ID (required).
  • GF_AWS_${profile}_SECRET_ACCESS_KEY: AWS secret access key (required).
  • GF_AWS_${profile}_REGION: AWS region (optional).

Auto upgrade plugins

Container tries to upgrade all installed plugins in the container automatically before Grafana start. If you want to disable this behaviour, please use environment variable -e UPGRADEALL=false.

Supported monitoring services



Devops Monitoring Expert, who loves monitoring systems and cutting/bleeding edge technologies: Docker, Kubernetes, ECS, AWS, Google GCP, Terraform, Lambda, Zabbix, Grafana, Elasticsearch, Kibana, Prometheus, Sysdig, ...


Professional devops / monitoring / consulting services:

Monitoring Artist