Linux

Where Is the Home Assistant configuration.yaml File?

Home Assistant /config directory with configuration.yaml and .storage for HA OS, Container and Core installs.

Last updated

Home Assistant centers on one directory holding configuration.yaml and the hidden .storage folder with UI-built helpers, devices and auth. Automations, scripts and scenes in YAML sit next to it.

The path depends on install type: /config for OS, Supervised and Container, a home folder for Core. Back up the whole directory, never just the YAML.

Where Home Assistant stores this, by platform

Linux
/config/configuration.yaml

Main config for Home Assistant OS, Supervised and Container installs. The .storage subfolder holds UI-configured state and must travel with the YAML. Core installs use ~/.homeassistant instead. Use the built-in backup or copy /config with Home Assistant stopped.

Frequently asked questions

What must I back up in Home Assistant?

The entire /config directory including hidden .storage. configuration.yaml alone misses everything built in the UI.

Where are Home Assistant automations stored?

YAML automations live in automations.yaml next to configuration.yaml, while UI-built items and device registries sit inside .storage.

Notice an outdated path? Let us know.