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 supervisor_info title="Configuration > Add-ons & Backups > System" %}
  2. Click the link that says "Join beta"
  3. Navigate to Configuration panel
  4. 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
     

{% 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. Switch to the user that is running Home Assistant

   sudo -u homeassistant -H -s
   

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

   source /srv/homeassistant/bin/activate
   

3. Download and install the beta version

   pip3 install --pre --upgrade homeassistant
   

4. When that is complete restart the service for it to use the new files.

{% endif %}