Skip to main content

Grafana in Docker

Introduction​

This guide will cover how to host a local Grafana instance as a Docker Container. This guide will use Portainer as a graphical front end for Docker, but the steps should remain relatively similar if using docker-compose or another graphical front end.

Prerequisites​

Docker must be installed before proceeding. Portainer can optionally be installed.

OSS vs Enterprise​

There are two versions: OSS (open source) and Enterprise. They are both free and have the same features. If you may want to get a license and pay for Grafana then use the Enterprise version as it can be unlocked without needing to reinstall. I will use the OSS version in this guide.

Stack File​

Open up Portainer and create a new Stack file. I use "grafana" as the name for my stack file. Paste in the below docker-compose into the stack file:

services:
  grafana:
    image: grafana/grafana-oss
    container_name: grafana
    ports:
      - "3000:3000"
    volumes:
      - grafana-data:/var/lib/grafana
    restart: unless-stopped

volumes:
  grafana-data:

Change Ports​

If you want to change the ports, update the ports section. The left value is what is exposed to your operating system. So to use port "9999" it can be updated to

    ports:
     - '9999:3000'

Sign In​

Open Web Browser​

By default Grafana should be running on http://localhost:3000. If you installed Grafana on a different host than what you use to connect to it, replace "localhost" with the internal IP address of the host where Grafana was installed.

Credentials​

The username and password is admin.

When prompted, change the password to something more secure.

Once you have signed in you can begin adding data sources and creating dashboards.