mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-29 22:36:50 +00:00
c73525a709
* Updates for python36 and scl Latest changes to installing the scl environment don't include the scl command, scl-utils is needed along w/ the proper repository in Centos7 to be enabled via RH and then downloaded to the environment which you are building and then SCL commands will work and setting python environment for bash will work too. * Minor changes
80 lines
3.0 KiB
Markdown
80 lines
3.0 KiB
Markdown
---
|
|
layout: page
|
|
title: "Installation on CentOS/RHEL"
|
|
description: "Installation of Home Assistant on your CentOS/RHEL computer."
|
|
date: 2017-03-01 07:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
---
|
|
|
|
To run Python 3.x on [CentOS](https://www.centos.org/) or RHEL (Red Hat Enterprise Linux), [Software Collections](https://www.softwarecollections.org/en/scls/rhscl/rh-python36/) needs to be activated first.
|
|
|
|
### {% linkable_title Using Software Collections %}
|
|
|
|
First of all install the software collection repository as root and [scl utils](https://access.redhat.com/documentation/en-US/Red_Hat_Developer_Toolset/1/html-single/Software_Collections_Guide/). For example, on CentOS:
|
|
|
|
```bash
|
|
$ sudo yum install centos-release-scl
|
|
$ sudo yum-config-manager --enable centos-sclo-rh-testing
|
|
$ sudo yum install -y scl-utils
|
|
```
|
|
|
|
Install some dependencies you'll need later.
|
|
|
|
```bash
|
|
$ sudo yum install gcc gcc-c++ systemd-devel
|
|
```
|
|
|
|
Then install the Python 3.6 package. If you are using CentOS 7 then you may have to install the packages for Python 3.6 using RHEL Methods listed here: https://www.softwarecollections.org/en/scls/rhscl/rh-python36/) for this to work as mentioned above.
|
|
|
|
```bash
|
|
$ sudo yum install rh-python36
|
|
```
|
|
|
|
This is part of the slight change when trying to install Python 3.6 and running the command `python36 --version` which will after install give you the correct version, but won't allow you to set the software collection using the `scl` command. This command downloads the RH collection of Python to allow you to run `scl` command to enable the environment in `bash` and then run the automate command using the template.
|
|
|
|
```bash
|
|
$ yum install rh-python36
|
|
```
|
|
|
|
### {% linkable_title Start using software collections %}
|
|
|
|
```bash
|
|
$ scl enable rh-python36 bash
|
|
```
|
|
|
|
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:
|
|
|
|
```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](/docs/installation/virtualenv/#step-4-set-up-the-virtualenv).
|
|
|
|
You will need to enable the software collection each time you log on before you activate your virtual environment.
|
|
|
|
### {% linkable_title Systemd with Software Collections %}
|
|
|
|
To autostart Home Assistant using systemd follow the main [instructions](/docs/autostart/systemd/) 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
|
|
```
|