{
  "manifest_version": "1",
  "slug": "grafana",
  "title": "Grafana",
  "headline": "Self-host Grafana and Prometheus",
  "description": "Run Grafana and Prometheus on an exe.dev VM: dashboards for all your VMs, HTTPS checks, email alerts, and exe.dev login instead of passwords.",
  "category": "monitoring",
  "tags": [
    "grafana",
    "prometheus",
    "node exporter",
    "server monitoring",
    "dashboards",
    "alerting",
    "blackbox exporter",
    "loki",
    "docker compose"
  ],
  "url": "https://exe.dev/deploy/grafana",
  "markdown_url": "https://exe-staging.dev/deploy/grafana.md",
  "upstream": {
    "website": "https://grafana.com/oss/grafana/",
    "source": "https://github.com/grafana/grafana",
    "docs": "https://grafana.com/docs/grafana/latest/",
    "license": "AGPL-3.0 (Grafana, Loki); Apache-2.0 (Prometheus, exporters)"
  },
  "example_vm_name": "my-grafana",
  "time": "15 minutes",
  "stack": [
    {
      "name": "Grafana 13.3",
      "detail": "grafana/grafana in Docker Compose; exe.dev login is the Grafana login",
      "port": 8000,
      "data": "~/monitoring/grafana/data"
    },
    {
      "name": "Prometheus 3.16",
      "detail": "prom/prometheus; 90 days or 5 GB of metrics, whichever comes first",
      "port": 9090,
      "data": "~/monitoring/prometheus-data"
    },
    {
      "name": "node_exporter 1.12",
      "detail": "A systemd service on this VM and on every VM it watches",
      "port": 9100
    },
    {
      "name": "Blackbox exporter 0.29",
      "detail": "HTTPS and certificate checks for your websites"
    },
    {
      "name": "Nightly backup",
      "detail": "Grafana's database and all config; two weeks kept",
      "data": "~/monitoring/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-grafana.exe.xyz/",
      "who": "private",
      "what": "Grafana, signed in as you; you're its admin"
    },
    {
      "url": "https://my-grafana.exe.xyz/",
      "who": "shared",
      "what": "Teammates you share the VM with, as Grafana viewers"
    }
  ],
  "delivers": [
    "Grafana at the VM's private URL, signed in with exe.dev, with the owner as admin.",
    "Prometheus collecting this VM's metrics, with a fleet dashboard and Node Exporter Full.",
    "Five starter alert rules that email the owner through exe.dev, no SMTP server.",
    "Website checks ready to fill in, and AI title and description suggestions through exe.dev's LLM gateway.",
    "Everything restarts after a reboot; nightly backups with one checked."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Grafana%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fgrafana.md%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-grafana.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-grafana.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20Grafana%20at%20the%20VM%27s%20private%20URL%2C%20signed%20in%20with%20exe.dev%2C%20with%20the%20owner%20as%20admin.%0A-%20Prometheus%20collecting%20this%20VM%27s%20metrics%2C%20with%20a%20fleet%20dashboard%20and%20Node%20Exporter%20Full.%0A-%20Five%20starter%20alert%20rules%20that%20email%20the%20owner%20through%20exe.dev%2C%20no%20SMTP%20server.%0A-%20Website%20checks%20ready%20to%20fill%20in%2C%20and%20AI%20title%20and%20description%20suggestions%20through%20exe.dev%27s%20LLM%20gateway.%0A-%20Everything%20restarts%20after%20a%20reboot%3B%20nightly%20backups%20with%20one%20checked.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20from%20top%20to%20bottom%2C%20skipping%20VM%20creation%20and%0ASSH.%20The%20walkthrough%20at%20the%20top%20is%20for%20the%20owner%20afterwards%3A%20don%27t%20add%0Aother%20VMs%20or%20websites%2C%20create%20integrations%2C%20or%20set%20up%20Loki%20or%20Tailscale.%0ADo%20not%20run%20Restore%20or%20Update.%0AWork%20as%20exedev%20in%20~%2Fmonitoring.%20Never%20overwrite%20an%20existing%20grafana.env.%0AThe%20owner%27s%20email%20comes%20from%20the%20reflection%20integration%3B%20if%20it%20prints%0Anothing%2C%20ask%20the%20owner%20for%20their%20exe.dev%20email%20and%20use%20that.%0ADon%27t%20send%20a%20test%20alert%20or%20email%3B%20the%20owner%20will.%20Leave%20the%20VM%20private%0Aand%20do%20not%20reboot.%20Verify%20docker.service%20and%20node_exporter%20are%20enabled%2C%0Aevery%20container%20restarts%20unless-stopped%2C%20and%20the%20checks%20in%20each%20step%20pass.%0AFinish%20with%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%20and%20the%20three%20steps%20from%20%22Watch%0Aanother%20VM%22%20with%20this%20VM%27s%20name%20filled%20in.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/grafana/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Grafana on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/grafana.md from top to bottom.\n\nThe recipe's example VM name is my-grafana. This VM's name is the output of `hostname`: use it wherever the recipe writes my-grafana. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- Grafana at the VM's private URL, signed in with exe.dev, with the owner as admin.\n- Prometheus collecting this VM's metrics, with a fleet dashboard and Node Exporter Full.\n- Five starter alert rules that email the owner through exe.dev, no SMTP server.\n- Website checks ready to fill in, and AI title and description suggestions through exe.dev's LLM gateway.\n- Everything restarts after a reboot; nightly backups with one checked.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" from top to bottom, skipping VM creation and\nSSH. The walkthrough at the top is for the owner afterwards: don't add\nother VMs or websites, create integrations, or set up Loki or Tailscale.\nDo not run Restore or Update.\nWork as exedev in ~/monitoring. Never overwrite an existing grafana.env.\nThe owner's email comes from the reflection integration; if it prints\nnothing, ask the owner for their exe.dev email and use that.\nDon't send a test alert or email; the owner will. Leave the VM private\nand do not reboot. Verify docker.service and node_exporter are enabled,\nevery container restarts unless-stopped, and the checks in each step pass.\nFinish with https://\u003cvm\u003e.exe.xyz/ and the three steps from \"Watch\nanother VM\" with this VM's name filled in.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/grafana/prompt.txt"
  },
  "updated": "2026-11-16",
  "verified": "2026-11-16",
  "related": [
    "uptime-kuma",
    "docker-compose",
    "postgres",
    "open-webui",
    "dev-test-prod",
    "agent-secrets"
  ],
  "alternatives": [
    "Grafana Cloud",
    "Datadog",
    "New Relic"
  ],
  "files": [
    "https://exe-staging.dev/deploy/grafana/alerts.sh",
    "https://exe-staging.dev/deploy/grafana/fleet.json",
    "https://exe-staging.dev/deploy/grafana/node-exporter.sh"
  ]
}
