Outcome
Set up a reliable holiday lighting workflow with calendar/schedule control, scenes, and safe season-end shutdown.
Audience and Scope
Audience: Home automation builder with intermediate Home Assistant and Docker experience
Estimated Time: 1-4 hours
Difficulty: intermediate
Before You Start
- All light controllers paired and named in Home Assistant.
- A holiday calendar source selected.
- Indoor/outdoor power safety checks complete.
Hardware and Software
Hardware
- Holiday-capable smart lights or controllers.
- Home Assistant calendar/holiday integration.
- Scenes for each holiday theme.
Software
- Holiday-capable smart lights or controllers.
- Home Assistant calendar/holiday integration.
- Scenes for each holiday theme.
Step-by-Step
Step 1: Group holiday lights
Objective: Create light groups by zone (roofline, tree, entry, etc.).
Actions:
- Implement group holiday lights according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If wrong colors load: open scene and re-save entity states.
Step 2: Build scenes
Objective: Create a scene per holiday with target colors/effects.
Actions:
- Implement build scenes according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If wrong colors load: open scene and re-save entity states.
Step 3: Add date-driven trigger
Objective: Trigger scenes from holiday/calendar events and optionally at sunset.
Actions:
- Implement add date-driven trigger according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If wrong colors load: open scene and re-save entity states.
Step 4: Add shutdown routine
Objective: Turn lights off at a fixed time nightly and disable seasonal automations after the season.
Actions:
- Implement add shutdown routine according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If wrong colors load: open scene and re-save entity states.
Step 5: Add manual override
Objective: Create one button to enable/disable all holiday automations.
Actions:
- Implement add manual override according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If wrong colors load: open scene and re-save entity states.
Step 6: Validate
Objective: Run through one full simulated day (sunset trigger + nightly off + override).
Actions:
- Implement validate according to your environment.
Verification:
- Confirm expected state in Home Assistant and logs.
- Run a manual test to verify expected behavior.
Common failure and fix: If wrong colors load: open scene and re-save entity states.
Validation Checklist
- Correct scene loads for selected holiday.
- Lights turn off at configured cutoff time.
- Override switch disables all holiday automations.
Operations and Maintenance
- Document update cadence for packages and containers.
- Schedule backup verification.
- Record service health baselines and alert thresholds.
Troubleshooting and Rollback
- If wrong colors load: open scene and re-save entity states.
- If trigger misses: verify timezone and calendar event format.
- If flicker/lag: reduce effect complexity and stagger turn-on actions.