github.com/tiredofit/docker-grafana
About
This will allow you to build a Docker image for Grafana.
Maintainer
Table of Contents
- github.com/tiredofit/docker-grafana
Prerequisites and Assumptions
Installation
Build from Source
Clone this repository and build the image with docker build -t (imagename) .
Prebuilt Images
Builds of the image are available on Docker Hub
docker pull docker.io/tiredofit/grafana:(imagetag)
Builds of the image are also available on the Github Container Registry
docker pull ghcr.io/tiredofit/docker-grafana:(imagetag)
The following image tags are available along with their tagged release based on what's written in the Changelog:
Container OS | Tag |
---|---|
Alpine | :latest |
Multi Architecture
Images are built primarily for amd64
architecture, and may also include builds for arm/v7
, arm64
and others. These variants are all unsupported. Consider sponsoring my work so that I can work with various hardware. To see if this image supports multiple architecures, type docker manifest (image):(tag)
Configuration
Quick Start
-
The quickest way to get started is using docker-compose. See the examples folder for a working docker-compose.yml that can be modified for development or production use.
-
Set various environment variables to understand the capabilities of this image.
Persistent Storage
File | Description |
---|---|
/var/run/docker.sock |
You must have access to the docker socket in order to utilize this image |
Environment Variables
Parameter | Description | Default |
---|---|---|
DB_TYPE |
DB engine type | sqlite |
DB_HOST |
Database host | localhost |
DB_PORT |
Database port | 3306 |
DB_NAME |
Database name | grafana |
DB_USER |
Database user | grafana |
DB_PASS |
Database passwor | password |
AUTO_ASSIGN_ORG_ROLE |
Role for auto-created user | Viewer |
OAUTH_ALLOW_INSECURE_EMAIL |
If you use Generic OAuth with an identity provider that does not support a unique ID field please set it TRUE |
FALSE |
Base Images used
This image relies on an Alpine Linux base image that relies on an init system for added capabilities. Outgoing SMTP capabilities are handlded via msmtp
. Individual container performance monitoring is performed by zabbix-agent. Additional tools include: bash
,curl
,less
,logrotate
, nano
.
Be sure to view the following repositories to understand all the customizable options:
Image | Description |
---|---|
OS Base | Customized Image based on Alpine Linux |
Parameter | Description | Default |
---|
Maintenance
Shell Access
For debugging and maintenance purposes you may want access the containers shell.
docker exec -it (whatever your container name is e.g. grafana) bash
Support
These images were built to serve a specific need in a production environment and gradually have had more functionality added based on requests from the community.
Usage
- The Discussions board is a great place for working with the community on tips and tricks of using this image.
- Sponsor me for personalized support
Bugfixes
- Please, submit a Bug Report if something isn't working as expected. I'll do my best to issue a fix in short order.
Feature Requests
- Feel free to submit a feature request, however there is no guarantee that it will be added, or at what timeline.
- Sponsor me regarding development of features.
Updates
- Best effort to track upstream changes, More priority if I am actively using the image in a production environment.
- Sponsor me for up to date releases.
License
MIT. See LICENSE for more details.