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

Running a development version

If you want to stay on the bleeding-edge Home Assistant Core development branch, you can upgrade to dev.

{% caution %} The dev branch is likely to be unstable. Potential consequences include loss of data and instance corruption. {% endcaution %}

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

1. Join the dev channel.

   ha supervisor options --channel dev
   

2. Reload the {% term "Home Assistant Supervisor" %}.

   ha supervisor reload
   

3. Update {% term "Home Assistant Core" %} to the latest dev 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.

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

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

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 version you want.

   pip3 install --upgrade git+https://github.com/home-assistant/core.git@dev
   

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

{% endif %}