From 1d0890d871e2537b0fd1a22e06b594c4581eaa83 Mon Sep 17 00:00:00 2001 From: aidbish <38182386+aidbish@users.noreply.github.com> Date: Sat, 6 Jul 2019 06:15:01 +1000 Subject: [PATCH 1/2] Updated broken links (#9785) * Updated broken link to mqtt broker relates to https://github.com/home-assistant/home-assistant.io/issues/9774 * Updated broken link - rflink sensor https://github.com/home-assistant/home-assistant.io/issues/9774 * :pencil2: Removed full url * :pencil2: Removed full url --- source/_components/arwn.markdown | 2 +- source/_components/sensor.rflink.markdown | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/arwn.markdown b/source/_components/arwn.markdown index e7bf2f46efa..615fefd03c1 100644 --- a/source/_components/arwn.markdown +++ b/source/_components/arwn.markdown @@ -17,7 +17,7 @@ redirect_from: The `arwn` sensor platform is a client for the [Ambient Radio Weather Network](http://github.com/sdague/arwn) project. This collects weather station data and makes it available in an MQTT subtree. -To use your ARWN setup, you must already have configured the [MQTT](mqtt) platform. Then add the following to your `configuration.yaml` file: +To use your ARWN setup, you must already have configured the [MQTT](/components/mqtt/) platform. Then add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry diff --git a/source/_components/sensor.rflink.markdown b/source/_components/sensor.rflink.markdown index 48db8fd7eb9..534aeb56080 100644 --- a/source/_components/sensor.rflink.markdown +++ b/source/_components/sensor.rflink.markdown @@ -58,7 +58,7 @@ devices: default: RFLink ID type: string sensor_type: - description: Override automatically detected type of sensor. For list of [values](components/sensor.rflink/#sensors-types) see below. + description: Override automatically detected type of sensor. For list of [values](/components/sensor.rflink/#sensors-types) see below. required: true type: string unit_of_measurement: From 8faccaaaad8a77e180c48cc8bba778da094352f9 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 5 Jul 2019 15:57:55 -0700 Subject: [PATCH 2/2] Remove OS specific mentions from virtualenv guide (#9786) * Remove OS specific mentions from virtualenv guide * Tweaks for comments. * Update virtualenv.markdown * Tiny tweaks now we are here anyway --- source/_docs/installation/virtualenv.markdown | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/source/_docs/installation/virtualenv.markdown b/source/_docs/installation/virtualenv.markdown index 170f7e5b39f..4164658a955 100644 --- a/source/_docs/installation/virtualenv.markdown +++ b/source/_docs/installation/virtualenv.markdown @@ -14,12 +14,15 @@ If you already have Python 3.6 or later installed (we suggest 3.7 or later), you It's recommended when installing Python packages that you use a [virtual environment](https://docs.python.org/3.6/library/venv.html#module-venv). This will make sure that your Python installation and Home Assistant installation won't impact one another. The following steps will work on most UNIX like systems. -_(If you're on a Debian based system, you will need to install Python virtual environment support using `apt-get install python3-pip python3-venv`. You may also need to install development libraries using `apt-get install build-essential libssl-dev libffi-dev python3-dev`.)_ - -

-It is recommended to use the [advanced guide](/docs/installation/raspberry-pi/) which allows for the installation to run as a `homeassistant` user. The steps below may be shorter but some users find difficulty when applying updates and may run into issues. +

+This is a generic guide for running Home Assistant under Python. We recommend to use [our recommended installation guides](/docs/installation/#recommended). The steps below may be shorter but some users find difficulty when applying updates and may run into issues.

+{% comment %} +This page describes installation instructions for a pure Python installation. +It should not contain any OS specific instructions. +{% endcomment %} + ### Install 1. Create a virtual environment in your current directory: @@ -34,20 +37,15 @@ It is recommended to use the [advanced guide](/docs/installation/raspberry-pi/) ``` $ source bin/activate ``` - 4. Install wheel: - ``` - $ python3 -m pip install wheel - ``` - 5. Install Home Assistant: + 4. Install Home Assistant: ``` $ python3 -m pip install homeassistant ``` - 6. Configure it to [autostart](/docs/autostart/) - 7. Or run Home Assistant manually: + 5. Run Home Assistant: ``` $ hass --open-ui ``` - 8. You can now reach the web interface on `http://ipaddress:8123/` - the first start may take up to 20 minutes before the web interface is available + 6. You can now reach the web interface on `http://ipaddress:8123/` - the first start may take a couple of minutes before the web interface is available. This can take longer if you're using lower-end hardware like a Raspberry Pi Zero. ### Upgrade @@ -60,7 +58,7 @@ It is recommended to use the [advanced guide](/docs/installation/raspberry-pi/) $ python3 -m pip install --upgrade homeassistant ``` 3. Start Home Assistant - 4. You can now reach the web interface on `http://ipaddress:8123/` - the first start may take up to 20 minutes before the web interface is available + 4. You can now reach the web interface on `http://ipaddress:8123/` - the first start may take some time before the web interface is available, depending on how many integrations need to be upgraded. ### Run a specific version @@ -74,7 +72,7 @@ $ pip3 install homeassistant==0.XX.X #### Run the beta version -If you would like to test next release before anyone else, you can install the beta version released every two weeks, for example: +If you would like to test next release before anyone else, you can install the beta version, for example: ```bash $ cd homeassistant @@ -102,6 +100,7 @@ $ pip3 install --upgrade git+git://github.com/home-assistant/home-assistant.git@ - In the future, if you want to start Home Assistant manually again, follow step 2, 3 and 5. - It's recommended to run Home Assistant as a dedicated user. +- If you want Home Assistant to automatically start at boot, check the [autostart docs](/docs/autostart/)

Looking for more advanced guides? Check our [Raspbian guide](/docs/installation/raspberry-pi/) or the [other installation guides](/docs/installation/). @@ -114,4 +113,5 @@ If you've upgraded Python (for example, you were running 3.7.1 and now you've in ```bash $ mv homeassistant homeassistant.old ``` -Then follow the [Install](/docs/installation/virtualenv/#install) steps again, being sure to use the newly installed version of Python. + +Then follow the [Install](#install) steps again, being sure to use the newly installed version of Python.