Home Assistant Community

How to help us help you - or How to ask a good question

help
Tags: #<Tag:0x00007fcf6090a010>
#1

Before we begin…

This forum is not a helpdesk

The people here don’t work for Home Assistant, that’s an open source project. We are volunteering our free time to help others. Not all topics may get an answer, never mind one that helps you solve your problem.

image
This also isn’t a general home automation forum, this is a forum for Home Assistant and things related to it. Any question about Home Assistant, and about using things with Home Assistant, is welcome here. We can’t help you with everything though.

:one: Search

It’s not unlikely that your question has been asked, and answered, already. If you search the forum, you may find it and save yourself a lot of time.

Now, it may not be a perfect answer to your question, but it should get you close enough to start.

When you’re writing a new topic, on the right-hand side (where the Preview panel is), you’ll see topic suggestions. These are chosen based upon your title, tags, and the post content. Do check them before you post.

If you find a post that solves your problem, please like that post. It’ll help others identify that post as helpful, and let that poster know that they’ve helped people.

:two: How do I search?

Try to search only for what is the core of your question - the error message (without your specific data), component or add-on name, the operation you want to perform, etc.

Some examples of searches for common scenarios:

  • hassio “no such image”
  • mqtt light
  • camera stream

:three: I found a similar topic but it’s already solved and I still have a problem. Should I post in it?

As a rule of thumb - no.

What you could do, is to post your question in a new topic and put a link to the topic you found (see also 9 Show your workings below).

:four: Did you read (and search) the documentation?

The documentation is here, and the component list is here. There are a few highly recommended sections that everybody should read:

The documentation and the components also have search functions.

Be warned, Home Assistant changes quickly. If you’re looking at a post in the forum, or somebody’s blog post, or a YouTube video, and that article is months old, it could turn out to contain outdated information. If you run into problems it’s good to check against the current documentation.

Don’t forget, add-ons will have their own documentation too. In many cases it will be embedded in the add-on, or accessible through it, but if not check the add-on page or the relevant GitHub repository (for a non-core add-on).

Good questions

:five: Use a relevant category

The categories are fairly self explanatory, and Uncategorized is where things without a category fall. Please try to help them end up somewhere else :wink:

The Hass.io category is for things relating to the Hass.io install method itself, and the add-ons. Questions about how to configure a component go elsewhere.

:six: Use relevant tags

Tags are added to a topic to help to improve the forum’s search engine, as well as give additional context to people reading your question.

Common tags include zwave, mqtt, templates, switch, etc.

:seven: Title

Having a good topic title is essential. It should summarise your post so that without even opening it people can have a good idea of what it’s about.

A good topic generally:

  • Includes unique part of the error you’re getting
  • Contains the component name or action description
  • Describes the thing you’re having an issue with
  • Is emotionless

For example:

  • Good How do I use a timer in an automation to delay an action?
  • Bad Timer not working
  • Ugly Problem/Need help
  • Good Z-Wave - Not able to include device ZXX123
  • Bad ZXX123 not discovered
  • Ugly ZWave problem

If you’re having a problem writing a good topic title, leave it for last - once you’ve written the whole question, it might be easier to write a summary title for it.

Asking the question

Before posting anything make sure that you read and follow the community standards

:eight: Describe the goal, not the problem

It’s all too easy to fall into the trap of the XY problem. If you describe your goal first, then others can understand what you’re trying to achieve.

:nine: Show your workings

If you turn up with a post that suggests you’ve put in no effort, you’re less likely to get quality help, and your post may even be ignored. Explain a bit of what you’ve done so far, such as:

  • Link to some other threads that you’ve found, and tried, and explain why they didn’t help you
  • Describe what you’ve tried, and what the problems were

Showing that you’ve put effort in will help demonstrate that you’re not simply looking for others to do all the work for you.

:one::zero: Tell us how you installed Home Assistant

Tell us if you’re running Hass.io using an official HassOS image, a Docker install, Hassbian, a venv install, and so on. Things that are often really useful to know include:

  • What version number of Home Assistant are you running?
  • How you installed it. If you’re not using Hassbian or a HassOS based Hass.io install, remember to tell us the operating system
  • Any relevant code - correctly formatted

For example:

  • Home Assistant 0.42.0 using Hass.io with the HassOS image
  • Home Assistant 0.84.2 in a venv following this guide on Windows 10
  • Home Assistant 0.90.2 using Hass.io on Ubuntu 18.04 following this guide

Please remember that words like latest, current, newest and so on are not version numbers.

:one::one: Format it properly

Spacing is critical in YAML, and if you just throw the code on the page then it’ll look ugly and nobody will know if the problem is because of spacing. We need you to use code blocks and appropriate markup.

For example, this is easy to read and it is obvious if the spacing is correct:

# Turn off lights when everybody leaves the house
  - alias: 'Rule 2 - Away Mode'
    trigger:
      platform: state
      entity_id: group.all_devices
      to: 'not_home'
    action:
      service: light.turn_off
      entity_id: group.all_lights

This however, not so much:

Turn off lights when everybody leaves the house

  • alias: ‘Rule 2 - Away Mode’
    trigger:
    platform: state
    entity_id: group.all_devices
    to: ‘not_home’
    action:
    service: light.turn_off
    entity_id: group.all_lights

Full details are in that link, but in brief you wrap your block in three backticks (```), like this:

```
# Turn off lights when everybody leaves the house
  - alias: 'Rule 2 - Away Mode'
    trigger:
      platform: state
      entity_id: group.all_devices
      to: 'not_home'
    action:
      service: light.turn_off
      entity_id: group.all_lights
```

:one::two: Describe what you changed

If it used to work, then tell us what changed since then. If you changed an automation, upgraded something (a custom component, an add-on, Home Assistant itself, etc), we need to know. Don’t just tell us the last change, tell us all the changes.

Remember too - only change one thing at a time, then test. If you change multiple things and it now works, you don’t know what solved it. Worse, one of those things may have solved it, but one of them may have introduced a new problem.

:one::three: Share the logs

If something isn’t working, check the logs and see if things are being logged. On Hass.io logs are available in the UI, or you can check them using the command line - hassio ha logs. On Hassbian you can use halog from the Hassbian scripts. Keep in mind that the UI will only show errors, and other entries may be helpful and relevant. Other sources will include:

  • Home Assistant log file homeassistant.log
  • Hass.io Supervisor log
  • Hass.io Add-on log
  • Z-Wave activity in OZW_Log.txt

The more you tell us, the more likely it is that the problem can be identified.

:one::four: Screenshots

Sometimes an image is worth a thousand words, and including a screenshot (or a link to one hosted elsewhere) can help. Don’t do that for anything you can copy and past from your configuration, YAML, code, or logs. Please only include screenshots that are actually helpful.

:one::five: Read before posting

Yes, read your own post before you post it. Make sure that you’ve not lost the point part way through, that it still makes sense, and that the topic, tags, and category all still make sense.

The other things to ensure is that you’re using paragraphs, punctuation and white space. A wall of text is hard to read.

:one::six: Should I tag people?

Generally, no.

It comes across as bad manners, you’re demanding somebody answers you. It’s different if you’re thanking somebody, obviously.

If you do tag somebody keep it polite and respectful. Remember that everybody is a volunteer, and nobody has to help you.

Similarly, please don’t PM (private message) people asking for help. It also comes across as demanding, and means that others can’t learn from what you do.


I’ve posted…

:one::seven: Wait…

Yes, the community covers the world, but those who can help you may not be around. It can easily take many hours, maybe even a day or so to get a response.

:one::eight: But it’s been days

If nobody has responded after a couple of days, have a re-read and see if the title, category, tags, or even the post itself need some attention. Re-read this guide and see if you’ve missed something important.

If you think that all is as good as you can make it, then you can consider bumping it by posting a reply to make it more visible. Doing that too much, or too quickly, can make you look entitled, and that will drive people away.

:one::nine: I’ve solved it!

Great. Please respond to your post with details how you solved it, and use the option to mark it as the answer (see 21 below).

Please don’t delete your question, that will make it look like you only care about yourself.

:two::zero: People are replying, but I don’t have the answer

This is common. There’s always going to be things people don’t know (because you didn’t tell them, and maybe didn’t even know to tell them, or because it’s beyond the limits of their knowledge).

If something that people have said has moved you on, then let them know. This will encourage people to keep helping you. If it hasn’t, let people know that you’ve tried their suggestion, and what happened. Again, this encourages people to keep helping you.

:two::one: Somebody’s answer solved it!

Fantastic!

Now, before you go… please take the time to mark that as the answer, you do that by selecting the three dots under the post:

image

Then select the check box:

image

Don’t forget too while you’re down there to click the heart to like the post, as a way of saying thank you.

:four::two: This can’t work, can it?

Try it :wink:

Remember, there’s never a guarantee you’ll get an answer - nobody is required to provide one. What you can do though is provide a post with relevant supporting information, that shows you’re trying. That will encourage people to help you.


Inspired by this awesome post over in the OpenHAB forums.

68 Likes
Raspberry pi 3 b+ - ideas
Annoying error in log to remove [device]
Severe Weather Alerts from the US National Weather Service
Welcome to the Home Assistant Community!
Hassio dont conect
Lovelace Gauge card
Alexa addon
Lovelace: Bringing back entity-filter (monster-card)
Has the BoM sensor failed for anyone else?
Shelly Cloud - new Component? How to implement it? API is available
Switch telnet - acionamento de reles via telnet
Sonoff T1-1 problem
Browser connection unavailable
Scrape information from car sell website
Update won't work
Lovelace: Bar Card
Scene.turn_on trigger not triggering
Unable to complete update to 0.92.0
Adding a test script into UI Lovelace
Why my switches are in unused entities and not in home page?
Automation with physically turned off Lamps
How to program 433 remote using raspberry
0.93: Essent, AmbiClimate, VS Code debugging
Help me, Obi-Wan
No Pip? No Platformio?
Installed and no progress at all lovelace cards yaml ui
Can't install docker-compose
Automation toubles, they did work now they dont
Automation based on value from sensor
Automation Condtions
Blink a light when someone new follow me on instagram (no ifttt)
[NOOB] How to add a cc2531 to HA in een VM
Custom Dark Sky Animated Weather Card
Restart Switches by Home Assistant
Koogeek DW1 BLE
Upgrading home assistant error
Upgrading home assistant error
Can I use a template in a SMTP image attachments?
Community Hass.io Add-on: Node-RED
Custom timed event entity state please help
DHT device on Raspberry GPIO - Not detected? error in logs
Unable to get fresh install to work
OZW_log.txt remains empty
Preparing Hassio forever
closed #2
pinned globally #3
IP Webcam motion detection zones
Help debugging this error please