Installation on CentOS/RHEL


To run Python 3.x on CentOS or RHEL (Red Hat Enterprise Linux), Software Collections needs to be activated first.

You must install Python 3.5.3 or later. Software Collections version of Python 3.5 is 3.5.1 so this guide uses Python 3.6.

Using Software Collections

First of all install the software collection repository as root. For example, on CentOS:

$ yum install centos-release-scl

Install some dependencies you’ll need later.

$ yum install gcc gcc-c++ systemd-devel

Then install the Python 3.6 package:

$ yum install rh-python36

Once installed, switch to your homeassistant user (if you’ve set one up), enable the software collection and check that it has set up the new version of Python:

$ scl enable rh-python36 bash
$ python --version
Python 3.6.3

You will be in a command shell set up with Python 3.6 as your default version. The virtualenv and pip commands will be correct for this version, so you can now create a virtual environment and install Home Assistant following the main instructions.

You will need to enable the software collection each time you log on before you activate your virtual environment.

Systemd with Software Collections

To autostart Home Assistant using systemd follow the main instructions and adjust the template as follows:

[Unit]
Description=Home Assistant
After=network.target

[Service]
Type=simple
User=homeassistant
# Make sure the virtualenv Python binary is used
Environment=VIRTUAL_ENV="/srv/homeassistant"
Environment=PATH="$VIRTUAL_ENV/bin:$PATH"
# ExecStart using software collection:
ExecStart=/usr/bin/scl enable rh-python36 -- /srv/homeassistant/bin/hass -c "/home/homeassistant/.homeassistant"

[Install]
WantedBy=multi-user.target