Grafana Docker Compose files

Docker Compose files to spin up an instance of Grafana.

How to run

Add a COMPOSE_ENV file and save its location as a shell variable along with the location where this repo lives, here for example /opt/containers/grafana plus all other variables. At env/fqdn_context.env.example you'll find an example environment file.

When everything's ready start Grafana with Docker Compose, otherwise head down to Initial setup first.

Environment

export COMPOSE_DIR='/opt/containers/grafana'
export COMPOSE_CTX='cncf'
export COMPOSE_PROJECT='grafana-'"${COMPOSE_CTX}"
export COMPOSE_FILE="${COMPOSE_DIR}"'/docker-compose.yml'
export COMPOSE_ENV=<add accordingly>

Start

docker compose --project-name "${COMPOSE_PROJECT}" --file "${COMPOSE_FILE}" --env-file "${COMPOSE_ENV}" --profile 'full' up --detach

Initial setup

We're assuming you run Docker Compose workloads with ZFS-based bind mounts. ZFS management, creating a zpool and setting adequate properties for its datasets is out of scope of this document.

Datasets

Create ZFS datasets and set permissions as needed.

  • Parent dateset

    zfs create -o mountpoint=/opt/docker-data 'zpool/docker-data'
    
  • Container-specific datasets

    zfs create -p 'zpool/docker-data/grafana-${COMPOSE_CTX}/grafana/data/db'
    zfs create -p 'zpool/docker-data/grafana-${COMPOSE_CTX}/grafana/data/logs'
    zfs create -p 'zpool/docker-data/grafana-${COMPOSE_CTX}/grafana/config'
    zfs create -p 'zpool/docker-data/grafana-${COMPOSE_CTX}/nginx/data/db'
    zfs create -p 'zpool/docker-data/grafana-${COMPOSE_CTX}/nginx/data/logs'
    zfs create -p 'zpool/docker-data/grafana-${COMPOSE_CTX}/nginx/config'
    

    When changing bind mount locations to real ones remember to also update volumes: in docker-compose.yml.

  • Change ownership

    chown -R 1000:1000 '/opt/docker-data/grafana-${COMPOSE_CTX}/grafana/data'
    

When done head back up to How to run.