Update Guide: Home Assistant & Ubuntu 24.04 to 24.10 + Python Migration

[MickLesk]

1. Backup Home Assistant

Before proceeding with the update, ensure you create a full backup of your Home Assistant instance.

2. Stop Home Assistant and Filebrowser Services

If Home Assistant is running, stop the service:

systemctl stop homeassistant.service

If the Filebrowser service is active, stop it as well:

systemctl stop filebrowser.service

3. Update System

Run the following commands to update your system:

sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
sudo apt autoremove

4. Set Release Upgrade Prompt

Modify the release-upgrades settings:

nano /etc/update-manager/release-upgrades

Change Prompt=lts to Prompt=normal.

5. Perform the Ubuntu Upgrade

Start the upgrade process:

sudo do-release-upgrade

If prompted to continue, confirm all with y or ENTER
You may also encounter prompts regarding configuration files. Select Y or I to install the package maintainer's version, or N to keep your current version (not recommended) - i recommend Y

Examples:

Continue [yN] y
To continue please press [ENTER] --> ENTER
*** sysstat (Y/I/N/O/D/Z) [default=N] ?  Y

6. Reboot System

After the upgrade completes, reboot the lxc:

reboot

7. Install Necessary Dependencies

After the reboot, install the necessary dependencies and stop homeassistant again:

systemctl stop homeassistant.service

apt-get install -y   curl   git   sudo   mc   gnupg   ca-certificates   bluez   libtiff6   tzdata   libffi-dev   libssl-dev   libjpeg-dev   zlib1g-dev   autoconf   build-essential   libopenjp2-7   libturbojpeg0-dev   ffmpeg   liblapack3   liblapack-dev   dbus-broker   libpcap-dev   libavdevice-dev   libavformat-dev   libavcodec-dev   libavutil-dev   libavfilter-dev   libmariadb-dev-compat   libatlas-base-dev   software-properties-common   libmariadb-dev   pkg-config

8. Remove Old Python Versions

Clean up any old Python 3.12 versions:

rm -rf /usr/lib/python3.*/EXTERNALLY-MANAGED
apt-get remove --purge -y python3.12 python3.12-dev python3.12-venv

9. Install Python 3.13

Install the required Python version:

apt-get install -y   python3.13   python3-pip   python3.13-dev   python3.13-venv

Make Python 3.13 the default:

ln -sf /usr/bin/python3.13 /usr/bin/python3

10. Set Up Home Assistant Virtual Environment

Navigate to the Home Assistant directory and set up a virtual environment:

cd /srv/homeassistant
python3 -m venv .
source bin/activate

Reinstall the required Python packages within the virtual environment:

python3 -m pip install webrtcvad wheel homeassistant mysqlclient psycopg2-binary isal

Exit the virtual environment:

exit

12. Update Home Assistant Systemd Service

Update the Home Assistant systemd service file:

cat <<EOF >/etc/systemd/system/homeassistant.service
[Unit]
Description=Home Assistant
After=network-online.target

[Service]
Type=simple
WorkingDirectory=/root/.homeassistant
Environment="PATH=/srv/homeassistant/bin:/usr/local/bin:/usr/bin:/usr/local/bin/uv"
ExecStart=/srv/homeassistant/bin/python3 -m homeassistant --config /root/.homeassistant
Restart=always
RestartForceExitStatus=100

[Install]
WantedBy=multi-user.target
EOF

13. Start Services & check status

systemctl daemon-reload
systemctl start homeassistant
systemctl start filebrowser (if you have it)

systemctl status homeassistant

After completing these steps and running service your Home Assistant instance should be running on Ubuntu 24.10 with Python 3.13.

[MickLesk]

Another option would be to shut down the old LXC and adjust the IP if necessary.

Then start up the old lxc and create an new LXC (with PR #1550) and then use the copy script. But this is not tested from me:

bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/blob/main/misc/copy-data/home-assistant-core-copy-data-home-assistant-core.sh)"

[schonzen]

I'm getting this from proxmox after rebooting on step 6:

run_buffer: 571 Script exited with status 255
lxc_init: 845 Failed to run lxc.hook.pre-start for container "101"
__lxc_start: 2034 Failed to initialize container "101"
TASK ERROR: startup for container '101' failed

[MickLesk]

then analyze with gpt 😄 thats an strange issue, because the pre-hook crashs

[schonzen]

I ended up trying manually running the relevant lines I found in your code here: https://github.com/community-scripts/ProxmoxVE/blob/4426d5409b35da900c76d48712bcbda7b52ff3a3/install/homeassistant-core-install.sh
and that worked. So, I can try testing something else for you later, if you are interested. I'll keep the relevant backups for a while.

[flavien26]

Same here, the 24.10 upgrade process corrupted my vm and it gives me the same error as you.

[MickLesk]

All answered 'yes' and enter? 🤔 Also the remove deprecated things?

Tryed on 5 LXC's and worked perfectly

[flavien26]

Yes, absolutely. I just put N for sshd, because I wanted to keep my old conf file, but I don't see the connection.
I will retest later, or I will reinstall it from scratch

[jennilicious]

I had an issue with step 10. It turns out the virtual environment is still calling python3.12.

# python3 -m venv .

The virtual environment was not created successfully because ensurepip is not
available.  On Debian/Ubuntu systems, you need to install the python3-venv
package using the following command.

    apt install python3.12-venv

You may need to use sudo with that command.  After installing the python3-venv
package, recreate your virtual environment.

Failing command: /srv/homeassistant/bin/python3.12

I had to run these instructions to remove the previous virtual environment with remnants of python3.12, then recreate the virtual environment:

1. cd /srv/homeassistant
2. Remove all traces of the old virtual environment: rm -rf bin/ lib/ include/ pyvenv.cfg lib64 share/
3. Then create the new virtual environment: python3.13 -m venv .

I was then able to follow the rest of the process in step 10:

source bin/activate
python3 -m pip install webrtcvad wheel homeassistant mysqlclient psycopg2-binary isal
exit

Everything works now 😄 Thank you so much for creating this guide.

[oliv99]

Under Proxmox host, I created a new LXC (9000) with

bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/homeassistant-core.sh)"

then get the copy script and run it

wget https://raw.githubusercontent.com/community-scripts/ProxmoxVE/refs/heads/main/misc/copy-data/home-assistant-core-copy-data-home-assistant-core.sh
chmod +x ./home-assistant-core-copy-data-home-assistant-core.sh
./home-assistant-core-copy-data-home-assistant-core.sh

the Result is:

Use to copy all data from a Home Assistant Core LXC to a Home Assistant Core LXC. Proceed(y/n)?y
[INFO] Home Assistant Data from '100' to '9000'
[INFO] Home Assistant Data from '100' to '9000'
Mounting Container Disks...
Copying Data...
[INFO] Successfully Transferred Data.

Working as expected

[JRDevo]

+1 here, worked like a charm.

EQMX (mqtt) didn't seem to like the changes immediately but resolved itself after a few restarts of both the container and proxmox host. Cant tell which :(

[micbuh]

it simply works. thx

[mmaura]

Not working for me because uid root on ".homeassistant" new dir on new ct make it's not usable. After changing uid from root to 100000 it's work like a charm.

Thank you.