Prometheus Grafana

Last change on 2024-11-05 • Created on 2022-06-20 • ID: CL-EC4B4
prometheus grafana logo

This app contains a ready Prometheus and Grafana installation. You can install it via the Hetzner Cloud Console or the Hetzner Cloud API.

Deploy to Hetzner Cloud

Grafana is an open source software for visualization of metrics. These metrics are provided by the application Prometheus.

Getting Started

Create your server as usual via the Hetzner Cloud Console. As an alternative to the operating system, you can select an app that you would like to have pre-installed.

Grafana and Prometheus is pre-installed when the image is booted, but not activated.

To activate Prometheus and Grafana, please log in to your server:

  • By SSH-Key, if you provided one when you created your server.
  • By root password, which you received from us by email when you created your server, if no SSH key was provided.

This will take you through a process where you can then use Grafana as usual from the web, with automatic Let's Encrypt support. It is also possible to access Prometheus via Web afterwards as well, depending on the installation choices.

Hetzner Cloud API

Instead of the Hetzner Cloud Console, the Hetzner Cloud API can also be used to set up a server with preinstalled Prometheus and Grafana.

  • For example via curl command from the command line

    curl \
       -X POST \
       -H "Authorization: Bearer $API_TOKEN" \
       -H "Content-Type: application/json" \
       -d '{"name":"my-server", "server_type":"cpx21", "image":"prometheus-grafana"}' \
       'https://api.hetzner.cloud/v1/servers'
  • Or via hcloud-cli

    hcloud server create --name my-server --type cpx21 --image prometheus-grafana

Image Content

Base OS

  • Ubuntu 24.04

Installed packages and containers

This image contains Docker and all other listed applications as Docker containers.

NAME LICENSE
Prometheus GGPLv3 (Apache 2.0)
Grafana AGPLv3
Node-Exporter GPLv3 (Apache 2.0)
Cadvisor GPLv3 (Apache 2.0)
Docker GPLv3 (Apache 2.0)
Watchtower GPLv3 (Apache 2.0)
Caddy-docker-proxy MIT

Passwords

We use auto-generated passwords which are stored in:

/root/.hcloud_password

Useful Commands

Reset your password

Grafana

In case of loss of the password for the user admin you can reset it via the grafana-cli. To do this, first log on to the server. Then execute the following command on the server and enter the password you want:

docker exec -it grafana grafana-cli --homepath "/usr/share/grafana" admin reset-admin-password <password>

The password for the user admin has now been reset.

Prometheus

If you want to change the password for the Prometheus Basic Auth, you can first generate a new password hash with the following command.

docker exec -it caddy caddy hash-password -plaintext <password>

Then change the hash value for the variable PROMETHEUS_ADMIN_PASSWORD in the file /opt/containers/prometheus-grafana/.env. Now stop the caddy container and start it again to finish the password change.

docker compose -f /opt/containers/prometheus-grafana/docker-compose.yml stop caddy
docker compose -f /opt/containers/prometheus-grafana/docker-compose.yml start caddy

For more information about the installed packages and containers, please refer to their official documentation:

For more information about Hetzner Cloud and Hetzner Cloud Apps, please refer to our official documentation:

Table of Contents