geoffwilliams@home:~$

Makerfabs ESPHome Weather Station CLI flash

Makerfabs ESPHome Weather Station is probably the coolest weather station you can buy for home use and under $100 too.

Headline feature of this weather station is that it’s an ESPHome device. This means completely open firmware you can flash yourself and even improve if you like.

If you have Home Assistant running on a Raspberry Pi somewhere, you can probably just plugin directly and follow the Makerfabs wiki instructions to flash the device.

I want to flash straight from my Linux laptop, here’s how:

Step 1 - Install ESPHome

Full Instructions: https://esphome.io/guides/installing_esphome/

# do not su/sudo
python -m venv venv
. ./venv/bin/activate
pip install esphome
esphome version

Should report something like Version: 2025.10.4.

Step 2 - Get Makerfabs source codes

Makerfabs publishes the ESPHome code for the device here: https://github.com/Makerfabs/Home-Assistant-Weather-Station

Clone this somewhere on your workstation

Step 3 - Adjust weather_station.yaml

In the top level of the git repo is a file weather_station.yaml which you need to customize for your site:

  1. .api.encryption.key - base64 encoded key to secure the weatherstation API - change it
  2. .ota[].password - hex(?) password to secure over-the-air firmware updates - change it
  3. .wifi.ssid and .wifi.password - edit for your home WIFI
  4. Rest of items, adjust as you like

Step 4 - Flash firmware

In a terminal, with venv loaded as above:

esphome run weather_station.yaml

This will compile and flash the firmware in one go. After flashing, it will connect a serial console and you can watch the device logs. Look for an IP address and note it down.

Docs: https://esphome.io/guides/getting_started_command_line/#first-uploading

Step 5 - Connect to home assistant

Rest of instructions are the same as Step 5 onwards in the instructions, eg:

  1. Open Home Assistant
  2. Settings -> Device and Services -> ESPHome
  3. Type IP address into Host, leave Port as 6053

After a minute or so you should see readings in Home Assistant - nice!

Pro tip

The weather station can be disassembled very easily by undoing the 3x butterfly bolts on the bottom. The stack then pulls apart and you have tool-less access to all sensors - useful if you want to check connections, change cables, etc.

Post comment

Markdown is allowed, HTML is not. All comments are moderated.