Switch to Python 3.10

• Home Assistant switched to Python 3.10 (clean install only)
• Appdaemon and Configurator remain at Python 3.9

In an effort to make managing python easier, I'm going to have it removed completely from the plugin manifest. Moving forward python will be initially installed from post_install.sh and reinstalled after Plugin UPDATES according to the version set in the rcvar. Hopefully this will allow users more freedom to upgrade Python (or not) at their own discretion.

Upgrading python for your existing plugin will require manual intervention. On average this will take at least 15-30 minutes to complete. However a few users have reported waiting over an hour for the Home Assistant web UI to become available again! The amount of time it takes will vary depending on the speed of your NAS and the number of integrations you have added to Home Assistant.

Remember to take a snapshot of your jail before attempting to upgrade python

iocage snapshot JAIL_NAME -n SNAPSHOT_NAME

Install the new python version then reinstall the Home Assistant service (virtualenv)

iocage console JAIL_NAME
# Press 0 to exit the menu
pkg install python310 py310-sqlite3
sysrc homeassistant_python=/usr/local/bin/python3.10
service homeassistant reinstall homeassistant

If something goes wrong you can revert to the snapshot you took before

iocage stop JAIL_NAME
iocage rollback JAIL_NAME -n SNAPSHOT_NAME

Add update-overlay script

This script should finally provide an easy way to update the plugin overlay without running a Plugin UPDATE. It can be run from the jail's console. With no options, it will pull the overlay directory from the master branch

# Press 0 to exit the menu
update-overlay

Or you can pull the overlay directory from the latest tagged release

# Press 0 to exit the menu
update-overlay release

Workaround an issue where Home Assistant fails to restart using GUI

The rc script runs Home Assistant using the FreeBSD daemon. This workaround simply adds the -R restart_delay_seconds to the rc-flags for the daemon. The default delay is set for 1 second.

 -R  restart_delay_seconds
	     Supervise and restart the program after the specified delay if it
	     has been terminated.

The delay can be adjusted by setting the rcvar homeassistant_restart_delay

For example, the following would set a 3 second delay

sysrc homeassistant_restart_delay=3 

fix for issue #52 - Home Assistant 2022.2 not starting

Switch to Python 3.9

This will start using Python 3.9 for all services on clean installs

Running a Plugin UPDATE should ensure all the requirements are met for Python 3.9

The services for this jail are installed in a Python Virtualenv

• After you update to version 7 - your installed services will continue to run a virtualenv with python 3.8

When the Python version changes, the services should be reinstalled

• After you update to version 7 - switch a virtualenv to python 3.9 by reinstalling the service

Reinstall the Home Assistant service (virtualenv)

• Python 3.8 has been deprecated
• Support will be dropped in Home Assistant 2022.1

iocage console $JAIL_NAME
# press 0 to exit menu
sysrc homeassistant_python=/usr/local/bin/python3.9
service homeassistant reinstall homeassistant

Reinstall Appdaemon or File Editor (virtualenv)

• Optional at this time

For appdaemon and configurator services, use number 8 to remove the virtualenv

When the service is removed, number 8 will change back to install

Temporary work around

• #46

Temporary work around

• #44

This includes both a Jail UPGRADE and a Plugin UPDATE

Part 1: Jail UPGRADE -- FreeBSD 12.2-RELEASE

• The plugin's manifest has been switched to the 12.2-RELEASE
• The packagesite has also been switched from quarterly to latest

Part 2: Plugin UPDATE -- Version 6 2021.03.07

• globally disabled pip-version-check and cache-directory
• use requirements and constraints during pip install
• Home Assistant Core will be reinstalled during this Plugin UPDATE

You will need to allow extra time before the Home Assistant UI is reachable after the update is finished

Jail UPGRADE and Plugin UPDATE

In most cases, the following steps hopefully provide a smooth Jail UPGRADE / Plugin UPDATE

Refresh INDEX for community plugins

Run Plugin UPDATE from the TrueNAS UI

You will need to allow extra time before the Home Assistant UI is reachable after the update is finished