Getting Started with Grafana & InfluxDB for Home Assistant

A smart home captures a lot of data. Visualizing that data can help you see long term trends in how your smart home is used.

Home Assistant is a great open source home automation platform. With so many integrations with the “internet of things” or IOT devices, a lot of information passes through Home Assistant.

Out-of-the-box Home Assistant has a recorder and history component. These are great tools to see what the state of something was at a certain point in time, or what time an automation executed. This is a basic way to look at the data captured by Home Assistant.

However there are some pretty big limitations. Because of the amount of data Home Assistant is collecting, storing that data can become quite cumbersome. It won’t take you long before your Home Assistant database sizes are in gigabytes, and your home automation starts to slow down because of it.

Thankfully Home Assistant has some integrations we can use. In my setup, I use the recorder and history components to track the last two days of history from Home Assistant. This ensures Home Assistant has a lean database, and I can debug something that went wrong by looking in the recorder.


The Latest In Your Inbox

Enter your email address below to receive my latest blog posts and videos about Home Automation in your Inbox


Why You Should Be Recording Data

The more information your smart home has, the smarter it can be. We tend to think of this data as sensor readings. “What is the temperature in the room right now?” would be a classic question answered by sensor data.

However long-term trends and data can also be important. Let’s take a look at some questions you might be able to answer by analyzing your sensor data over longer periods.

  1. How much light does the living room get in winter months, compared to summer months?
  2. What’s the average temperature inside during the summer months, compared to winter? Are we cooling/warming the house too much?

To answer these types of questions, we need to use a separate system. Home Assistant comes with a few options, but today we’re going to setup Grafana, which is a free and open source graphing dashboard that looks beautiful.


The Database

There are two parts to this setup. First, is the database. By default Home Assistant will store its history in an SQLite database in your configuration directory. These files can get pretty big over time, so we’ll want to keep our long-term data somewhere else.

There’s a few options for this, but one with great support in Home Assistant is InfluxDB.


The Interface

The second part is the interface. Which is Grafana. There’s a few ways to install Grafana, but because I’m using Home Assistant on my Synology NAS, I’m going to use Docker.

I looked around, but ended up creating my own Docker image based on this awesome Docker setup by Samuele Bistoletti, Sams’s does everything I need, but it comes installed with StatsD/Telegraf, and uses MySQL. As I want to be able to store the data from InfluxDB and Grafana, I created my own Docker image which allows that. This way if you decide to upgrade to a newer version of InfluxDB/Grafana in the future, you’ll have the data available on your host machine, and it won’t get destroyed if you remove the Docker container from your system.

There’s more details about this container and how you can use it on the GitHub Repository.


Configuring InfluxDB & Home Assistant

So at this point I’m expecting you’ve got InfluxDB and Grafana installed and up-and-running. Oh, one of the great things about using InfluxDB is that you could have it running on a separate machine. So, if you’re using Home Assistant on a Raspberry Pi, you could have InfluxDB running on a PC or NAS that’s always on. That way your historical data doesn’t take up space on your SD card.

We’ll first need to setup a database in InfluxDB. Navigate to your InfluxDB installation. If you followed my Docker instructions, you’ll find it running on port 3004, otherwise it uses port 8086 for non-docker installations.

We’ll be presented with the InfluxDB Web Interface. We’re going to run a query to create a new database just for Home Assistant.

Once you’ve run that query, a new database will have been created for Home Assistant to use. Because we’re not going to expose InfluxDB to the open internet, I’m not going to bother configuring a username and password to access this table. If you feel more comfortable doing that, check the InfluxDB documentation on how to add users to InfluxDB. Just remember that you’ll need to give your user read/write access for Home Assistant to write data into InfluxDB.

Our next step is to configure Home Assistant to start logging changes to InfluxDB. To do this, we’ll add the following to our configuration file. Remember to add your username and password if you set one up.

You can change the IP address to the IP address where your InfluxDB install is running if needed. I’m using localhost because my Home Assistant Docker container is running on the same machine.

By default this is going to send everything to InfluxDB. If there’s anything you don’t want recorded in there, you can use the exclude parameter. There’s more information on the options in the Home Assistant component page.

Once you’ve added this to your configuration, be sure to restart Home Assistant. Watch your Home Assistant log files for any errors to make sure the connection to InfluxDB is working as expected.


Getting to know Grafana

Before we start setting up Grafana, let’s first learn a bit about it.

Grafana allows you to setup Dashboards with graphs and widgets. The dashboards can be configured with multiple types of graphs out-of-the-box. You can easily change what time period is displayed on the screen from the top-right menu. You can also configure it to refresh automatically. Great for a wall mounted display that needs to display realtime stats, like temperatures etc.

You’ll be able to setup multiple dashboards, and even multiple users. You could for example, have a user account for downstairs, and one for upstairs. You can then login to Grafana on the downstairs tablet, knowing someone won’t be able to access the upstairs dashboard without the correct username and password.

Another great feature of Grafana are Alerts. You could have Grafana send you alerts if the temperature inside reaches a certain threshold. This is a great way to keep your Home Assistant automations clean and tidy, by letting a reporting system take care of alerting you to a less critical problem.


Setting Up Grafana

Now it’s time for the main event. Now that we’ve got data being recorded into the InfluxDB database, we want to use Grafana to make some nice charts of it all.

The first thing you’ll need to do is setup a username and password. This first username and password will be the ‘root’ user, which will have complete access to Grafana. We’ll use this account to setup the dashboards. I’m going to skip over creating multiple users. If someone has access to all my Grafana dashboards, there’s probably bigger problems to solve first.

We’ll also need to configure our data source, which is going to be InfluxDB. This is us setting up Grafana so it knows where to pull our stats from. Click the Grafana icon at the top left hand side of the page, and then click Data Sources.

You’ll then need to setup how Grafana will communicate with InfluxDB. If you’re using my Docker container, here’s how I’ve set it up.


Creating the first Chart

Once you’ve setup your data source, we can start off by creating a simple temperature line chart. This chart will display the outside temperature, we’ll also include an area which will display the current temperature, and the highest and lowest temperatures for the time period specified.

At the top of the page are some icons for types of things you can add to your dashboard. Simply drag-and-drop an icon onto your dashboard. Let’s drag-and-drop a new Graph.

You’ll be presented with a blank graph now. Let’s click Panel Title to bring up the context menu to edit the graph.

Click the Edit button to open the graph editor at the bottom of the screen.

Here we can see how the graph is defined. Expand the “A” query to see how it is built. This is where we’ll make some adjustments to how the graph is reading the data from InfluxDB.

Now we’re going to make the following adjustments to the graph:

  • Where it says select measurement, we’re going to click it and then type in C to select Degrees Celsius, or F to select Degrees Fahrenheit (if you’re that way inclined). This will change the graph to only display temperature data collected from every sensor in Home Assistant.
  • Next to the WHERE, click the + button and select entity_id. We’re going to restrict the data displayed to only show the entity_id of the outside temperature.
  • Where it now says select tag value search for your outside temperature’s entity_id. I am using the Dark Sky Weather component, so my entity ID that I want is dark_sky_temperature.
  • In the GROUP BY we want to change the $interval. Grouping is used where there may not be enough data over certain periods. Let’s change it to group by 5 minutes.
  • In the ALIAS BY name it something like Outside Temperature. This will give the data a name so we know what we’re looking at

Now you should have data on your graph, but something looks wrong? The lines don’t seem to match up. This is because we may not have any data points for the period. Maybe Home Assistant only reads the temperature outside once an hour from Dark Sky. We could adjust our GROUP BY interval higher, to something like an hour which might solve that. However if there’s ever a time when we get multiple reports per hour, the graph would only display one value per hour.

Let’s instead tell Grafana to join the lines together based on the previous reading.

From the Display tab, on the right-hand-side under Stacking & Null value, select Connected for Null value. As soon as you do this, your graph should look much better.


Adding Some Information

Looking at the graph is cool, but it doesn’t make it easy to see what the temperature outside is right now, or what was the lowest/highest temperature for the period.

Go to the Legend tab then let’s select Min, Max and Current to be shown. This will add the values below the graph. Under Options select To the right to move the table inline with the graph. We’ll set the minimum width for the legend to 350. You should now have something like this:


Adding More Data

Now that looks pretty good so far. However we have a whole bunch of temperature sensors inside which we could add in. Go back to the Metrics tab, and click the Add Query button. This will create a new query under “B”.

We have two options now. We could choose to display each rooms temperature sensor individually. Or we could choose just to aggregate all the sensors into one, and just display the Outside vs Inside temperature on this graph.

I’m going to show you how to do both.

First, let’s start off by adding the living room to this graph. We’ll follow the exact steps as above for the outside temperature, but this time selecting the entity ID for the temperature of the living room sensor. In my case this is living_temperature_198 which comes from my Vera Lite. This adds a yellow line, and the entire graph now has the living room temperature compared to the outside temperature.

Now let’s press the Add Query button again, and add all our internal sensors together.

Let’s start by doing the exact same setup as Query B, by selecting the Living room entity ID again. Now we need to add another sensor to this query. Press the + button next to the entity_id to add to the query. You’ll see a blue AND appear. Click the AND to change it to an OR. Then, click select tag value to choose an entity_id of another temperature sensor.

Now let’s make some final cosmetic changes. Under the General tab, let’s change the Panel Title to Temperatures. Then in the Axes tab, let’s change the Left Y axes unit from short to Celsius/Farenheit.

Rinse and repeat for other graphs you might want to create as well, like Lux/Brightness, download speeds, etc.


Recording Battery Levels

Another option to display data is Singlestat. I find these great to show gauges of battery levels in devices.

Here’s where it can get a bit tricky. Some devices in Home Assistant will add another sensor to report the battery level. Others however will report the battery level as an attribute to the entity_id, which makes it hard to read in Grafana/InfluxDB.

As a habit, I’ve always created template sensors to extract the battery levels so I can display them in Home Assistant. This makes it easy to read the battery levels into Grafana.

As a sample of how to do this in Home Assistant, here’s some code I use to display the battery level for the entry sensor above.

Once I have these in Home Assistant, it’s easy to get the value into Grafana and InfluxDB.


Adding a Singlestat

Now we’ve got an easy way to get battery levels into InfluxDB and Grafana, let’s set up a gauge to display the battery percentage of a door sensor.

Go ahead and drag a Singlestat onto your dashboard. If you can’t see the menu where to add it from, on the left-hand-side near each row are three vertical ellipsis. Click those to bring up a context menu for the row, and click Add Panel.

Once again click the Panel Title and then Edit. Expand Query A to change the query that is building the data.

Click the select measurement and this time choose %. In the WHERE we want to choose entity_id and select the battery sensor. For my entry sensor above, I’m going to choose battery_entry_sensor. My sensor doesn’t report that often, so I’ll select 1 hour as the GROUP BY period, or you could set it to auto if you want.

We now have a basic Singlestat added to the dashboard.

Now let’s add the fancy gauges. From the Options tab under Gauge select Show. Straight away you’ll see the gauge appear.

Now let’s go to the Coloring column and in the Thresholds type in 10,25. This will make any value below 10% come up as red, and any value below 25 as orange. Anything else will be green, and you can customise the colours if you wish. Finally under the Value column, set the Postfix to % and the Unit to Percent (0-100). Back in the General tab we can give then panel a title, which I’ll name as Entry Sensor. Now we should have something that looks better.


Adding Attributes to a Graph

I mentioned that I create template sensors for extracting the battery levels for my devices. Although this works for me, it might not work for you, or there might be other attribute data you might want to track. Power levels reported by my Aeotec Smart Switch 6 units are recorded in attributes for example.

There are ways we can get this into Grafana, as it is stored in InfluxDB.

When creating a new query, instead of choosing the unit of measurement first, like % or KB/s, select the entity_id you would like to get the attribute for. In my entry sensor example above, I would choose binary_sensor.entry_motion_227. Once selected, change the SELECT field(value) so it reads field(battery_level).

Just remember that you’ll only be able to report on values with numbers. So states like Home vs Not Home might get a bit tricky.


Ideas for Use

So now we have the basic understanding of how to create a dashboard in Grafana (don’t forget to hit the save button!!). What can we do with it?

First, there’s heaps of types of data we can graph now:

  • Battery percentages over time, see how quickly batteries are used across your sensors to identify which ones are depleting the quickest
  • Power usage for main appliances like TV’s, Fridges, Heaters and Airconditioners
  • Moisture levels in your indoor plants (I use the MiFlora Flower Sensors for these)
  • Download rates for applications like Transmission
  • Internet Speed
  • TV Volume Level (I can see what volume levels my Sonos Playbar is currently set to)
  • Humidity Levels in bathrooms to see what time of day people are showering  or who’s having extra long showers (Z-wave multisensors are great for this)

Now we can take a look at this data over longer periods, for fun and potentially to save money. You can use the data to refine what the temperatures need to be inside vs outside before the AC comes on for example. Or how often your Rain Bird watering system should water your garden, based on how quickly the moisture in the soil dries out. If you notice that your fridge/freezer has started to use more power than usual, it might need a new seal or something.

There’s also some great options to setup alerts. Continuing the fridge/freezer example, if it starts to use more power than usual for the day, send an alert. Someone may have not closed a door properly. Or if your AC usage goes over X amount, send an alert that you’re going to have an expensive day, and consider opening a window instead.

Of course these are just some ideas I’ve had. What are you tracking or hoping to track in your Grafana dashboard?

Recommended Posts
  • Tijmen Schoemaker

    Hi Phil,

    Great tutorials! Im just getting started with Home Assistant, but i love it already! I used your docker image top setup InfluxDB and Grafana. InfluxDB is working fine! But i cant seem to set username and password to protect it from the outside? Also, the Grafana interface doesnt seem to show up 🙁

  • Jocke

    Hi, Awsome article! Helped me a lot. One small question, I’m new to the whole docker thing. How do I update Grafana and Influxdb? Is it only to ssh to the container and update ?

    • Thanks Jocke! Glad it helped you.

      Yeah so you should be able to SSH in on port 22022 to update anything you want. Just note that if you ever destroy the container, the updates will be lost.

      What version are you looking to upgrade to? If there’s some awesome new features etc that make the upgrade worth it, I might update the image to those versions too.

      • Jocke

        I have had some problems with other dashboards that is using $__interval . When searching for the problem I noticed that $__interval variable was introduced in Grafana in version 4.2.

        • Ah right!

          Can you try $interval instead? When I create a new item, that is the default interval grouping. So wonder if they just renamed $interval to $__interval

          • Jocke

            Seems to work with $interval. Seems like for influxdb its the same.

            “In the InfluxDB data source, the legacy variable $interval is the same variable. $__interval should be used instead.”

  • ASA

    Great article! I snaffled your docker-hub image and ran it up to try and its awesome. Thank you!

  • Ced

    Hi Phil,
    Thanks a lot for your articles. These helped a lot to get the home started.

    One question with the docker image: How do you increase the influcdb connection pool? I’m getting a lot of error messages on the HA panels…

    Also, I hope this can help newbies (like me) get your image started, here are the commands I had to use (DSM 6.1 did not like -v):

    docker run -d

    –name grafana

    -p 3003:3003

    -p 3004:8083

    -p 8086:8086

    -p 22022:22

    –mount type=bind,source=/volume1/docker/influxdb,target=/var/lib/influxdb

    –mount type=bind,source=/volume1/docker/grafana,target=/var/lib/grafana


    • Hey Ced,

      Thanks for posting your docker run command. I’m a bit worried that your Synology 6.1 wouldn’t accept the -v flag. That’s very annoying (and another reason for me not to upgrade DSM). Hopefully they fix that in a future release.

      So, from my Google research it looks like you have to set the connection pool when connecting to InfluxDB. So, this would have to be done from Home Assistant. I have some good news and bad news for you.

      The good news is you’re not the only one experiencing this. Infact, there’s been a fix put in place on the InfluxDB side, after some others reported the same here:

      I can see there’s a pull request to add a new paramater to Home Assistant which will fix this here:

      The bad news is that’s not on the official Home Assistant repo yet. So, it’s still a work in progress for the time being. If there’s an update needed to InfluxDB, my container won’t get it yet either. I’ll wait for this fix to bubble up to Home Assistant before I look at upgrading versions in my container (I try to live by if it’s not broken, don’t fix it).

      That doesn’t really help you for the moment. I’m wondering though, if you could exclude everything from trying to go into InfluxDB, and then only select the entities you do want to go in. By default Home Assistant will try to push everything into your InfluxDB, including input_boolean, automations, weather etc. If you instead choose the things most important you want to graph, this should reduce the number of calls to InfluxDB Home Assistant needs to make, and hopefully avoid the error you’re seeing.


      • Ced

        Cheers for this,

        Grafana is a fantastic tool. I need to find ways to import the graphs back into Home Assistant now!

        Yes, I saw the repo for connection pool increase. I’ll have to wait until this works in the released version…
        I’ll try to limit requests as suggested for the time being.

        Some research is needed… but, first, I’ll implement the device tracking for essential components you wrote on.

        Keep up the good work buddy.

  • Tim Samuelsson


    I used this command on nm synology with DSM 6.1:

    sudo docker run -d –name influxdb-grafana -p 3003:3003 -p 3004:8083 -p 8086:8086 -p 22022:22 -v /volume2/SSD/influxdb:/var/lib/influxdb -v /volume2/SSD/grafana:/var/lib/grafana philhawthorne/docker-influxdb-grafana:latest

    influxdb on port 3004 works but grafana on 3003 dosent give any response at all….

    The log says the following:

    2018-01-24 15:00:56,529 INFO exited: grafana (exit status 1; not expected)
    2018-01-24 15:00:57,532 INFO spawned: ‘grafana’ with pid 1565
    2018-01-24 15:00:57,596 INFO reaped unknown pid 1578
    2018-01-24 15:00:58,598 INFO success: grafana entered RUNNING state, process has stayed up for > than 1 seconds (sta
    2018-01-24 15:01:09,651 INFO exited: grafana (exit status 1; not expected)
    2018-01-24 15:01:10,654 INFO spawned: ‘grafana’ with pid 1631
    2018-01-24 15:01:10,720 INFO reaped unknown pid 1644
    2018-01-24 15:01:11,721 INFO success: grafana entered RUNNING state, process has stayed up for > than 1 seconds (sta
    2018-01-24 15:01:22,767 INFO exited: grafana (exit status 1; not expected)
    2018-01-24 15:01:23,770 INFO spawned: ‘grafana’ with pid 1698
    2018-01-24 15:01:23,834 INFO reaped unknown pid 1711
    2018-01-24 15:01:24,835 INFO success: grafana entered RUNNING state, process has stayed up for > than 1 seconds (sta

    It looks like grafana cant start properly, do you have any clue why?

    • Hey Tim,

      That’s strange. Unfortunately, the process manager inside the container won’t display any errors from Grafana.

      I have a hunch that it is an issue with Grafana not being able to read/write to your config directory. Could be a permissions issue. I would first chmod 777 the Grafana config, and see if that fixes it.

      If that still doesn’t fix it, I would then SSH into the container on port 22022. Then try and start Grafana manually and see if there’s any errors in the console that might lead you to where the problem is. Once logged in, the command you’ll want to run is


      • Tim Samuelsson

        Hi, it was a permission error.

        I changed the owner in File Station to my User and now grafana works 🙂

        Many thanks for your guides!

  • Ricardo Neiva

    Hi there,

    Just installed grafana and influxdb on Synology and configure them with HomeAssistant and just love this.
    Can you tell me how to update influx and grafana?

    • Unfortunately you’ll need to SSH into the container on port 22022 and run the update commands manually for now.

      • Ricardo Neiva

        How can I change the influxdb config? Can’t SSH to 22022, get connection refused.
        O want to view config because I installed telegraf but it can’t write in influxdb

        • The InfluxDB config should be exposed by a volume mount. You should be able to edit it from the host.

      • signaleleven

        That’s an “antipattern” in docker. The proper way would be to pull the updated image and recreate the container.

  • meaple

    No idea why, but I’m getting error message
    root@DS-713:~# docker run -d –name docker-influxdb-grafana -p 3003:3003 -p 3004:8083 -p 8086:8086 -p 22022:22 -v /path/for/influxdb:/var/lib/influxdb -v /path/for/grafana:/var/lib/grafana –restart=always philhawthorne/docker-influxdb-grafana:latest
    docker: Error response from daemon: Bind mount failed: ‘/path/for/influxdb’ does not exists.

  • Vince M

    great guides! I have a question. My battery sensors all of a sudden show N/A% even though my other sensors are still giving data. Any ideas why this would be?

    • Thanks Vince,

      Hmm interesting. Might be an issue with the template you’re using to extract them. Maybe the entity_id has changed or something.

      Mind posting one of your sensors you’re using to extract the battery level?

      • Vince M I have a feeling it’s a polling issue or something because the battery levels show after a restart of HA. I feel like it polls initially and then stops.

        • Hmm yes it could be.

          What component is it? Does the component expose its own outside_garage_door_battery sensor? Or is that another sensor you’ve exposed?

          • Vince M

            they’re zwave devices. a few are the aeotec multisensors and one is a zwave schlage door lock.

          • Ah interesting.

            Then yes, I’m guessing that the battery level hasn’t been polled yet. Generally, battery devices will send out their battery devices to the z-wave network once every 24 hours. So, it could be you have to keep your HA online for 24 hours so it receives the updates from all the nodes. It may not save the last poll value over restarts though.

          • Vince M

            Is there a way to get it to update at least every hr or so? Or when the sensor wakes?

          • There is. Unfortunately, each device is slightly different, so you’ll need to consult the instruction manual for each device.

            You’ll be looking at changing the reporting intervals, and possibly group reports. Just keep in mind by increasing the frequency of these reports, you’ll be using more of the battery, so battery life will be affected.

            You can set z-wave parameters from within Home Assistant. I believe there is a Z-wave set config service, or it might be available from the Config panel.

          • Vince M

            i checked my zwave config and the group reports (which includes batteries) are set to report every 4 minutes. Not exactly sure why the data does not show up.

  • Shane Bekker

    Thank you for your guides.

    I am stuck though with this error in HASSIO logs

    Setup failed for influxdb: Component failed to initialize.
    2:49 PM (ERROR)
    Database host is not accessible due to ‘404: 404 page not found ‘, please check your entries in the configuration file (host, port, etc.) and verify that the database exists and is READ/WRITE
    2:49 PM components/ (ERROR)

    I can however get to the web UI for inlfuxdb. Seems like a permission issue which I am not sure how to fix.

    My configuration file has this entry:
    port: 3004

    • Strange, I am not 100% sure if this will work with HASSIO. Although I can’t see why not exactly.

      It sounds like the Home Assistant container can’t access the InfluxDB container. Are you able to change the host to might help.

      Otherwise we somehow need to link the Home Assistant and InfluxDB networks together. I am not sure if HASSIO supports this though.

  • J. Mouton

    Thanks for the guide

    I have copied your code

    – platform: template
    value_template: ‘{% if sensor.fibaro_system_fgms001zw5_motion_sensor_battery_level is not none %}
    {{ sensor.fibaro_system_fgms001zw5_motion_sensor_battery_level }}
    {% else %}
    {% endif %}’
    unit_of_measurement: ‘%’
    friendly_name: ‘Bewegingsmelder grote kamer’

    and get this error : Could not render template Bewegingsmelder grote kamer: UndefinedError: ‘sensor’ is undefined

    Can you help me out ?

    • Hmm I may have missed the “state.” in the code.

      Can you try this?

    • Hmm I may have missed the “state.” in the code.

      Can you try this?

      • J. Mouton

        THanks for helping me out Phil, but I still have the same error. But I think it has nothing to do with your code.I’m sorry about that
        this is the error
        [custom_components.sensor.template] Could not render template Bewegingsmelder grote kamer: UndefinedError: ‘sensor’ is undefined
        So I think it has something to do with ?

    • Vince M

      i believe that’s a zwave right? you could try this:

      - platform: template
      value_template: '{% if states.zwave.fibaro_system_fgms001zw5_motion_sensor %}
      {{ states.zwave.fibaro_system_fgms001zw5_motion_sensor.attributes.battery_level }}
      {% else %}
      {% endif %}'
      unit_of_measurement: '%'
      friendly_name: 'Bewegingsmelder grote kamer'

      • Vince M

        sorry not sure how to do proper spacing on this so i’m just showing a pic of it:

        • No problem, and can you see the attributes for the battery level in the states panel?

          • J. Mouton

            I can see attributes, but no battery status 🙁

          • Vince M

            not sure what you mean. Do you mean a sensor for an additional zwave device? If so, just use the same as above, but switch out the name to the new sensor in the value_template.

          • J. Mouton

            Thanks Vince, that was what I meant

          • Vince M

            no problem. let me know if that works for you

          • J. Mouton

            it isn’t 🙁

        • J. Mouton

          Hey Vince, thanks.
          In the overview screen I see the battery sensor now ( no errors anymore whoohooo 😉 ), but it’s giving me n/a … What could be wrong ?

  • J. Mouton

    How can I show them in HASS ? (sorry for al those questions)

    • Which sensors do you want to show in the UI? The battery sensor or the Grafana charts?

      • J. Mouton

        Both 😉

        • 🙂

          Well, for the Home Assistant UI, once you’ve made your attributes their own sensors with template sensors it should be a simple matter of just adding the applicable entity_id to your groups file. However if didn’t split them out with a template sensor, there isn’t much you can do.

          Now for the grafana graphs. I’ve added a link to the menu which links to Grafana for now. You can do that using the iFrame panel component. If you want the graphs inside the UI, I’m not 100% sure how to go about this. You might be able to use custom_ui or something to put an iframe inside Home Assistant, and then grab the URL for the graph from inside Graphana.

  • J. Mouton

    This is my actual Watt from my sma solar converter. Can I make something like this in singlestat ?

    If I can get the actual value it would be already ok

  • Andrea Donno

    Hi Phil thank you for this tutorial i’m using HA on DSM6. I managed to install and configure Grafana and influx db have added the influxdb line in HA but i’m not getting any graf data.
    Grafana is connecting to the DB without any issue
    Do you have any idea where thi could come from ?

    • Hey Andrea,

      I’m assuming you’re using Docker. What is your docker run command? You’ll need to expose the ports to Influx as well (although I’m sure you did this, if you can access Grafana).

      What is your congiruation YAML like for connecting to Influx? Are there any logs in the HA logs files?

    • Hey Andrea,

      I’m assuming you’re using Docker. What is your docker run command? You’ll need to expose the ports to Influx as well (although I’m sure you did this, if you can access Grafana).

      What is your congiruation YAML like for connecting to Influx? Are there any logs in the HA logs files?

      • Andrea Donno

        Hi Phil thanks for your reply

        So nothing in my log except some unrelated issues with XKNX

        – platform: template
        sensors: !include template/sensors.yaml


        # Text to speech
        – platform: google

        My grafana influxdb and HA are on the same device running DSM 6.1

        I copied the following docker run command:

        docker run -d
        –name grafana
        -p 3003:3003
        -p 3004:8083
        -p 8086:8086
        -p 22022:22
        –mount type=bind,source=/volume1/docker/influxdb,target=/var/lib/influxdb
        –mount type=bind,source=/volume1/docker/grafana,target=/var/lib/grafana

        • OK that’s interesting. That’s what I have in for my setup as well. Wondering if its a DSM6 network kind of issue.

          To test, can you change your docker run command to

          That will bind the container to the host network, which will hopefully work.

          • Andrea Donno

            that makes it worse , grafana is then unable to connect to influxDB

            When using the gui i noticed that no volumes are mapped i added them again via the gui but that didn’t solve the issue either

          • I thought it might 🙁

            So I have no idea why its not working for you. Seems very strange. Going to give you another option to try.

            There’s some upgrades to the latest versions of Grafana, InfluxDB and the base image on my repo. I haven’t tested them myself yet, but this might get it working for you.

            Here’s another new Docker run command to try

            Not sure if it will help, but you never know.

          • Andrea Donno

            Hey Phil , sorry for my late answer i had a packed day and thank you for your time

            By using that command i am unable to access grafana afterwards. I get to influxdb but nothing under http://serveraddress:3003

  • Juan Perez

    Phil, short note to thank you for creating/sharing this container. Got started with a nice System-Monitor Dash. I initially used the glances container along with the plugin, but reverted to HA native sensors + some CLI sensors as the glances set up is significantly resource consuming. In my case normal load CPU load is about 20%, with glances running it nearly doubled.

    • Thanks Juan!

      That dashboard looks sexy! Thanks for the heads up about Glances. Haven’t used that yet, but good to know its a bit hungry.

  • Colm Finn

    I can add the data source in Grafana fine, it confirms the home_assistant database is created fine but HA gives an error and does not connect. Both running on docker on the same host
    2018-06-17 21:10:03 ERROR (SyncWorker_3) [homeassistant.components.influxdb] Database host is not accessible due to ‘HTTPConnectionPool(host=’’, port=8086): Max retries exceeded with url: /query?q=SHOW+SERIES+LIMIT+1%3B&db=home_assistant (Caused by NewConnectionError(‘: Failed to establish a new connection: [Errno 111] Connection refused’,))’, please check your entries in the configuration file (host, port, etc.) and verify that the database exists and is READ/WRITE

    • Hmm sounds like the two containers can’t talk to each other.

      I would first confirm that both Home Assistant, and the Influx container are both using the host network.

      Then, I would change the IP address from to the network IP address (example

      • Colm Finn

        I get the same thing Phil. Both are running in docker, both are in the opt_default docker network and have local IP’s in the same subnet

        2018-06-18 14:38:55 ERROR (SyncWorker_5) [homeassistant.components.influxdb] Database host is not accessible due to ‘HTTPConnectionPool(host=’’, port=8086): Max retries exceeded with url: /query?q=SHOW+SERIES+LIMIT+1%3B&db=home_assistant (Caused by NewConnectionError(‘: Failed to establish a new connection: [Errno 113] No route to host’,))’, please check your entries in the configuration file (host, port, etc.) and verify that the database exists and is READ/WRITE
        2018-06-18 14:38:55 INFO (MainThread) [homeassistant.setup] Setup of domain influxdb took 7.1 seconds.
        2018-06-18 14:38:55 ERROR (MainThread) [homeassistant.setup] Setup failed for influxdb: Component failed to initialize.

        port: 8086
        I’ve tried it with port commented out also

        • Colm Finn

          Sorted it. I changed HA to run network host and added a firewall rule for port 8123.

  • kris10an_nys

    Hi Phil,

    Thamks for your great guide! Quick question: How do you control the size of the Influxdb? Sounds like an ever growing pool of data if no retention is set. How do you handle this? Thanks

    • Hmm to be honest I haven’t taken much thought about that, as the data is housed on my NAS (where I don’t really care too much about storage limits for now).

      I think the default retention period is 6 months, but yes longer periods might become something to think about.


  • Ian Rose

    Phil, geat guide as always!Have got my NAS operating as a broker and now this using your guides.
    Stuck on one thing though. Trying to show the volume of my Sonos using singlestat and it’s working. The only problem is the volume is shown as a value between 0 and 1 so it is showing .45% etc. Anyway of showing as a correct percentage?

    • Nice!

      I think you might have to extract these values out into a template sensor in Home Assistant. Something like

      Then use the new sensor.sonos_volume in your Grafana instance.

      Hope that helps.


      • Ian Rose

        Worked perfectly.

      • Ian Rose

        Worked perfectly.

  • zitterbacke

    Hi Phil, I’m using your grafana-influxbd docker container on my Synology NAS for more than a year now and I like it so much with my home automation. I’m wondering wether you could update the docker container with some more recent versions of grafana and influxdb? That would be great. Do you think it will be possible?

    BR Jens

    • Sure can!

      I’m actually testing it out for a few weeks now, almost ready for release I think. For now, just use the :edge tag in your docker run statement, and you’ll have some newer versions to use!

      • zitterbacke

        Hi Phil, what is the best way to update to the new version? I want to prevent losing any of my existing data and dashboards and want to have a “seamless” transition to the new version. Do I have to take special care on anything here? Thanks in advance for a short hint and support.

        • Hi Jens,

          If you’re worried, I would suggest taking a backup of your influxdb and grafana mount folders. Then you can easily restore back to the older version if necessary.

          With saying that, when I’ve upgraded I never had any data loss, either from Grafana or Influx. So it should be pretty seamless

          • zitterbacke

            Hi Phil,

            Thanks a lot for your reply. I did it according to your proposal and indeed the upgrade went seamless. Now I’m very happy with the new versions of Grafana and InfluxDB. By the way: In order to get the new versions I had to use the “edge” flag instead of “latest”, is that the correct way to use?

            Kind regards

          • Hi Jens,

            The “edge” tag will always have the latest and greatest that I have upgraded it to. I do this so I can first run it to ensure everything still works, before pushing it to the main “latest” tag when I get time.


  • Scott Smith

    Hello Phil, I just installed the InfluxDB-Grafana docker. All indications were good but I am not getting any data from home assistant first I used the loopback address in my YAML file because I am running both home assistant and Influx on the same NAS. After I noticed that no data was being populated I changed the address in my YAML file to the actual internal ip address.


    Any thoughts?

  • valepe

    Hi Phil,
    I tryed to install your container on my Synology NAS with DSM 6.2 but it seems not work properly.
    It runs without issues and creates files and folders under mapped folders.
    Port 3003 works: I see the page from Grafana
    Port 3004 not works: server not respond
    Port 8086 not works: error 404 – page not found
    If I try port 8083 I see the page from Chronograf but it asks me to create a connection and I don’t know how to create the home assistant database.

    What’s happening? Can you help me?

  • Richard Lewis

    Hi Phil,
    I just installed your container using the updated port numbers in your Github repro. I can connect to p3003 fine for Grafana, and 3004 fine for Chronograf – but how do I get to the Influxdb landing page in your video so that I can set up an influx db?

    • Hey Richard,

      The Influx admin panel was removed in a newer version of Influx in favour of Chronograf. Your best bet is to execute the queries from Chronograf to create the database.

      • Richard Lewis

        Ok – that makes sense. In the mean time I managed to create the necessary database and users through the CLI instead – so all up and running now.

  • Mark Rennie

    Hi Phil, I’ve come back to this as I want to have persistent logs kept for my energy meters. I don’t really need grafana as I want to import the values from influxdb into lovelace cards. Any idea how I could pull data from influxdb and create new sensors in HA please?

  • zitterbacke

    Hi Phil, I’m wondering how to edit the grafana.ini? To do it via ssh root@YourDockerHost -p 22022 and then to edit the file doesn’t work for me anymore. I always get a “Connection refused”. In the former Grafana version that way worked for me. Can you give me a hint how to do it?


    • Hey zitterbacke,

      Latest versions of the container have disabled SSH. Best to check the readme on the Github repo, but this should work for you now

      • zitterbacke

        Hi Phil,

        Thanks for your swift reply and support. It works!

        Cheers Jens

  • alphabeta

    Great article – got this up and running a week ago on my Synology NAS with DSM 6.2 – interestingly when I had to restart my Synology it appears to have wiped the influx db (ie the docker container wasn’t running, so nothing worked), then when I restarted it there was no home_assistant database. Recreating the database seems to have got it working, but I’ve now lost all the history – am I missing something with ensuring persistence of data here??

    • Thanks!

      Be sure that what you put in the “-v /path/for/influxdb:/var/lib/influxdb ” exists and writeable. You may need to chmod it to 0777 incase the user inside the container doesn’t have permission to write to the host system, which can sometimes happen.

      Also, do a “docker ps -a” to see if the old container (which was running before the reboot) is still there, but just not running. If so, a docker restart on it might bring it back with the data still there if you’re lucky.


      • alphabeta

        Thanks Phil – will have a poke tonight! As an aside – is there any GUI-focused ways to control docker containers? I’m a total dunce when it comes to CLI commands!

        • Yup couple of options.

          Synology has a Docker UI. Which can be limiting for some of the commands/flags you might need to set. But its there running when you installed the Docker package from DSM.

          If that doesn’t work, there is something called Portainer. You can run it as its own Docker container and manage other containers on the host system.

          Finally there is my own HA-Dockermon which allows you to start/stop containers from within Home Assistant.

          • alphabeta

            Great stuff – I’ll investigate! Agree re Synology’s Docker UI – had a poke and useful for simple stuff, but bit limited. Will check out your links, thanks!

  • Hazardous Dangerous

    is there a way to have some form of binary value for sonos if it is playing or not

    my use case: we have sonos multi room audio and i want to find a way of having just a easy to see playing/not playing on my smart home dashboard. currently i can’t find any stats for my sonos speakers on grafana even though all 12 are in home assistant, but other devices like lightbulbs show up fine

    • You might be able to use a template sensor for that.

      Use a binary template sensor, with the template doing an if speaker_a playing or speaker_b playing etc, then something is playing. You should be able to expose that to Grafana

Start typing and press Enter to search