home-assistant / home-assistant.io

:blue_book: Home Assistant User documentation
https://www.home-assistant.io
Other
5.02k stars 7.31k forks source link

Install Home Assistant Core #35318

Open pw44 opened 1 month ago

pw44 commented 1 month ago

Feedback

On this link, there is the instruction to install HASS Core

https://www.home-assistant.io/installation/generic-x86-64/#install-home-assistant-core

Also instructs to pip3 install homeassistant==2024.10.3

But there is no mention to UV and by this one, a lot of errors.

URL

https://www.home-assistant.io/installation/generic-x86-64/

Version

2024.10.3

Additional information

No response

frenck commented 1 month ago

Hi there @pw44 👋

Thanks for opening documentation feedback. Could you clarify/share the errors you are having? Without that, we have no idea what is wrong.

../Frenck

pw44 commented 1 month ago

Hi there @pw44 👋

Thanks for opening documentation feedback. Could you clarify/share the errors you are having? Without that, we have no idea what is wrong.

../Frenck

I have the following:

`/etc/systemd/system/home-assistant.service [Unit] Description=Home Assistant After=network-online.target

[Service] Type=simple User=homeassistant WorkingDirectory=/var/homeassistant/.homeassistant ExecStart=/var/homeassistant/bin/hass -c "/var/homeassistant/.homeassistant" Environment="PATH=/var/homeassistant/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" Environment="UV_SYSTEM_PYTHON=1"

[Install] WantedBy=multi-user.target`

After update (sudo -u homeassistant -H -s, cd /var/homeassistant, python3.12 -m venv, source bin/activate, pip3 install --upgrade homeassistant) i get:

`2024-10-20 11:01:32.317 INFO (SyncWorker_4) [homeassistant.util.package] Attempting install of aioesphomeapi==27.0.0 2024-10-20 11:01:32.623 ERROR (SyncWorker_4) [homeassistant.util.package] Unable to install package aioesphomeapi==27.0.0: error: The interpreter at /usr is externally managed, and indicates the following:

To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install.

If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv. Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed.

If you wish to install a non-Debian packaged Python application, it may be easiest to use pipx install xyz, which will manage a virtual environment for you. Make sure you have pipx installed.

See /usr/share/doc/python3.12/README.venv for more information.

Consider creating a virtual environment with uv venv. 2024-10-20 11:01:32.624 ERROR (MainThread) [homeassistant.setup] Setup failed for 'bluetooth_adapters': Requirements for esphome not found: ['aioesphomeapi==27.0.0']. 2024-10-20 11:01:32.624 ERROR (MainThread) [homeassistant.setup] Unable to set up dependencies of 'ibeacon'. Setup failed for dependencies: ['bluetooth_adapters'] 2024-10-20 11:01:32.624 ERROR (MainThread) [homeassistant.setup] Setup failed for 'ibeacon': Could not setup dependencies: bluetooth_adapters 2024-10-20 11:01:37.427 INFO (MainThread) [homeassistant.components.binary_sensor] Setting up upnp.binary_sensor 2024-10-20 11:01:37.427 INFO (MainThread) [homeassistant.components.sensor] Setting up upnp.sensor 2024-10-20 11:01:37.431 INFO (MainThread) [homeassistant.bootstrap] Home Assistant initialized in 15.51s 2024-10-20 11:01:37.431 WARNING (MainThread) [homeassistant.bootstrap] Detected that frontend did not load. Activating recovery mode 2024-10-20 11:01:38.135 ERROR (SyncWorker_9) [homeassistant.util.package] 2024-10-20 11:01:38.135 ERROR (SyncWorker_9) [homeassistant.util.package] Unable to install package home-assistant-frontend==20241002.3: error: The interpreter at /usr is externally managed, and indicates the following:

To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install.

If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv. Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed.

If you wish to install a non-Debian packaged Python application, it may be easiest to use pipx install xyz, which will manage a virtual environment for you. Make sure you have pipx installed.

See /usr/share/doc/python3.12/README.venv for more information.

Consider creating a virtual environment with uv venv.`

I'm not undestanding the suggestion of Consider creating a virtual environment with uv venv

Maybe a new install instruction considering the uv section would solve all theses problems, where some less instructed in python and virtual environments would have at least the chance to do a real upgrade as upgrading python, creating a new environment or venv and install new getting rid of this uv errors.