home-assistant.io/source/_includes/common-tasks/beta_version.md

Run a beta version

If you would like to test next release before anyone else, you can install the beta version.

{% if page.installation == "os" or page.installation == "supervised" %}

{% tabbed_block %}

• title: From the UI content: |

  1. In your Home Assistant UI navigate to {% my updates title="System > Updates" %}
  2. Click the overflow menu in the top right corner
  3. Click "Join beta"
  4. Navigate to Configuration panel
  5. Install the update that is presented to you

• title: From the CLI content: |

  1. Join the beta channel

     ha supervisor options --channel beta
     

  2. Reload the supervisor

     ha supervisor reload
     

  3. Update Home Assistant core to the latest beta version

     ha core update --backup
     

     The --backup flag here ensures that you have a partial backup of your current setup incase you need to downgrade.

{% endtabbed_block %}

{% elsif page.installation == "container" %}

docker pull {{ site.installation.container }}:beta

You then need to recreate the container with the new image.

{% elsif page.installation == "core" %}

1. Stop the Home Assistant service.

2. Switch to the user that is running Home Assistant

   sudo -u homeassistant -H -s
   

3. Activate the virtual environment that Home Assistant is running in

   source /srv/homeassistant/bin/activate
   

4. Download and install the beta version

   pip3 install --pre --upgrade homeassistant
   

5. When that is complete start the service again for it to use the new files.

{% endif %}