Introduction:

After updating to Home Assistant version 2025.12.0 some errors may appear. Just download the zip file again and replace the files (dashboard and yaml).

In this post I am going to guide you through the process of integrating your analogue gas meter into Home Assistant. After going through this guide you are able to track gas consumption with the Home Assistant Energy Dashboard. Also, you have the most complete GasmeterDashboard for Home Assistant you can dream of.

You can use the default Home Assistant Energy Dashboard and you can use the Advanced Gas Meter dashboard from Smart Gateways shown below:

Click here for a LIVE DEMO. Username: demo – password: smartgateways

Making your old gas meter smart

You can wirelessly read your analog gas meter using WiFi, making it a smart device. Transforming your analogue gas meter into a smart gas meter allows you to remotely access and track your gas consumption through a user-friendly gas consumption overview. By doing so, you can conserve gas, which contributes to environmental sustainability. The recommended solution for achieving this is the Smart Gateways Gas Meter Gateway. By attaching a sensor to the gas meter, it records gas usage and transmits the data to Home Assistant.

If you are not sure if your gas meter is compatible with the gateway, just send a message to Smart Gateways and they will check if your meter works with the Gas Meter Gateway. You can use the contact form on their website for this.

Connecting your Gas Meter to Home Assistant

In this post, I will guide you on creating a comprehensive dashboard that displays all the values from the Smart Gateways Gas Meter Gateway. The dashboard not only presents consumption and costs per day, week, month, and year but also empowers you to make your gas meter intelligent by utilizing the Smart Gateways Gas Meter Dashboard for Home Assistant. Actually Smart Gateways was the first company providing an off the shelf solution that could make your analogue gas meter smart.

The Smart Gateways Gasmeter Dashboard for Home Assistant is the perfect complement to Home Assistant’s existing energy dashboard. Of course you can use both dashboards next to each other. Just pick the dashboard you like the most.

Home Assistant Energy Dashboard with Gas usage shown below:

Pre-requirements to setup the dashboard

Setting up the dashboard can be done in a few easy steps. Complete each step one by one and verify if the step is completed before proceeding with the next step.

1. First install Mosquitto MQTT Broker on Home Assistant using this manual
2. Connect the Gas Meter Gateway using the Installation Manual found on the Smart Gateways Support page
3. Enter the MQTT settings on the internal webpage of the Gas Meter Gateway
4. Install HACS (Home Assistant Community Store) using this manual

Install the Apexcharts-card plugin into Home Assistant

When you completed all the above steps it’s time to add the apexcharts-card repository to Home Assistant. You have to do this using HACS.

1. Click HACS on the sidebar of Home Assistant
2. Click Frontend
3. Click EXPLORE & DOWNLOAD REPOSITORIES in the lower right corner
4. Type apexcharts-card in the Search for repository box
5. Click DOWNLOAD in the lower right corner
6. Select the latest version and Click DOWNLOAD
7. RELOAD the browser to activate the apexcharts-card plugin

Add additional MQTT Configuration for diagnostical data

The Advanced Gasmeter Dashboard for Home Assistant will show some diagnostical data from the Gasmeter Gateway. This data is sent by the gateway through MQTT. You can add this to Home Assistant by adding a mqtt file. You first have to install the File editor Add-on.

1. Within your Home Assistant frontend/home navigate to the Settings menu
2. Click Add-ons
3. Click ADD-ON STORE in the lower right corner
4. Go to the Search add-ons box
5. Type File editor
6. Click on File editor from the list
7. Click INSTALL and wait for the File editor to be installed
8. Enable Start on boot, Show in sidebar and Watchdog
9. Click START to start the broker

Add the Packages directory to Home Assistant and place some configuration files

When using the packages directory for all your .yaml configuration files, you are able to sort all configuration in specific files for each integration. You have to edit the configuration.yaml file first for Home Assistant to use the packages directory.

1. The file editor is shown in the sidebar. Click on the File editor icon
2. Click on the configuration.yaml file
3. The contents of the configuration.yaml file are shown
4. Insert the following configuration into the file:

   • homeassistant:
       packages: !include_dir_named packages

5. Click the save button (Floppy Disk Icon) on the upper right corner to save the configuration.yaml
6. Click on the Browse File System Icon on the upper bar
7. Click on the New Folder icon (second icon)
8. name the new folder packages
9. Click OK
10. Download the following file (disable pop-up blockers)
11. Click here to download file
12. Unpack the zip file
13. Place the file smartgateways_gasmeter.yaml in the packages folder by using the Upload File button within the File editor Add-on
14. Save the file
15. Restart Home Assistant

Add the Advanced Energy Dashboard to Home Assistant

When you completed all the above steps it’s time to add the Advanced Energy Dashboard to Home Assistant.

1. Enable Advanced Mode for your user account
   • Within your Home Assistant frontend/home navigate your user profile (in the lower left corner)
   • Enable Advanced Mode to unlock advanced features
2. Open the file gasmeter_dashboard.txt from the downloaded zip file and copy the contents of this file to the clipboard
3. Click the three dots in the upper right corner of the dashboard in Home Assistant
4. Click on the 3 dots again
5. Click Raw configuration editor
6. Scroll till the end and start a new line
7. Paste the contents of the Dashboard panels file into the editor
8. Click SAVE in the upper right corner
9. Close the editor by clicking the cross on the upper left corner
10. Restart Home Assistant
11. Notice the new Advanced Gas Meter Dashboard.

Gas Costs

It is possible to enter the costs for gas consumption into the dashboard. There are 3 values to be filled in. You can find those values in the lower right corner. Please note that these costs are based on gas consumption in the Netherlands. You can ask your energy company for the prices.

• Gas – Belasting: Tax on gas (per m3)
• Gas – Prijs per liter: Price per m3
• Gas – Vastrecht: Fixed price you have to pay per year to the energy company

Prices have to be filled in in m3.

Adding the Gas Meter Gateway to the Home Assistant Energy Dashboard

1. Within your Home Assistant frontend/home navigate to the Settings menu
2. Click Dashboards
3. Click Energy in the lower right corner
4. Go to Gas Consumption
5. Click ADD GAS SOURCE
6. Add connectix_gasmeter_totaal
7. Click SAVE

If everything went right you will see your gas consumtion on the Energy Dashboard: