Home Assistant Configuration Files

This directory stores version-controlled copies of Home Assistant configuration files.

Purpose

• Recovery: Restore automations and configurations without HA backup
• Version control: Track changes over time
• Code review: Review automation YAML before deploying

Security

Never store secrets in this repository: - API keys - Passwords - Tokens - Personal identifiers

Use Home Assistant's secrets.yaml for sensitive values.

Directory Structure

Organize config files by category:

configs/
├── README.md              # This file
├── automations/           # Automation YAML by category
│   ├── security.yaml
│   ├── lighting.yaml
│   ├── environmental.yaml
│   └── system.yaml
└── scripts/               # Script YAML (if version controlled)

Workflow

1. Create/edit automation in Home Assistant UI or YAML
2. Copy the YAML to the appropriate file in this directory
3. Commit and push
4. Reference in ha_automations.md