Releases

A new version of Home Assistant comes out on the first Wednesday of every month. Before that, there is a week of beta testing. After it, there are weekly patch releases with fixes. That rhythm has been the same for years, and everyone who contributes works with it.

This area explains how that cycle works, and how you can help. You do not need to be a developer for most of it: testing a beta, reporting what broke, and making release notes clear are some of the most useful things anyone can do.

• Your first contribution: join the beta, and test the next release in your own home.
• How releases work: the monthly cycle, from development to patch releases.

For everyone:

• Release notes and the release party: how the release notes are made, and how to help.

For developers, when your change affects users:

• Document a backward-incompatible change: explain to users what changes, and what to do about it.
• Deprecate something: how removing something works, and how long it takes.
• Get a fix into a patch release: how fixes reach the beta and the patch releases.

• Versions and channels: what a version number means, and the stable, beta, and dev channels.
• Who does what: the people involved in a release.

• Testing a beta? Join the #beta channel on the Home Assistant Discord server.
• Found a bug in a beta? Report it in the issue tracker of the part that broke. See Your first contribution.
• The release and beta dates are in the events calendar.