Skip to main content
The configuration.yaml file in Home Assistant is the core configuration file. You might need to edit it occasionally to change fundamental Home Assistant features that can’t be configured in the Home Assistant UI. Here’s how to access the Home Assistant configuration.yml file for editing:

​
Option 1 - Use VS Code Server Add-on

This is the easiest and preferred way to edit configuration.yml if your Home Assistant supports add-ons.
  1. Open the Home Assistant dashboard
  2. Go to the settings menu.
  3. Select Add-ons
  4. Select “Add-on Store”
  5. Find the add-on called “Studio Code Server”
  6. Install the addon, and start it.
  7. Select “Open in Web UI”
  8. Select “configuration.yaml” in the Explorer list.
  9. Make any edits needed.
  10. Save the configuration.yml file.
  11. Restart Home Assistant for the change to be applied.

​
Option 2 - Use SSH To Edit The Config

Use this option if your Home Assistant server doesn’t support add-ons and you know how to SSH into it.
  1. SSH into the device running Home Assistant.
  2. Look for the Home Assistant config file; it could be in a few places.
    1. /home/homeassistant/.homeassistant/configuration.yaml
    2. ~/.homeassistant/configuration.yaml
  3. Use a command-line text editor, such as nano, to edit the file.
  4. Restart Home Assistant for the change to be applied.