jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Site updated at 2017-06-18 20:53:55 UTC

Browse source
This commit is contained in:
Travis CI 2017-06-18 20:53:55 +00:00
parent 2f720f9d86
commit a220a8fef9
34 changed files with 671 additions and 307 deletions
Download patch file Download diff file Expand all files Collapse all files

58
faq/index.html
View file

@ -8,7 +8,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<title>FAQ - Home Assistant</title>
<meta name="author" content="Home Assistant">
<meta name="description" content="Home Assistant' FAQ">
<meta name="description" content="Home Assistant's FAQ">
<meta name="viewport" content="width=device-width">
<link rel="canonical" href="https://home-assistant.io/faq/">
<meta property="fb:app_id" content="338291289691179">
@ -16,12 +16,12 @@
<meta property="og:site_name" content="Home Assistant">
<meta property="og:url" content="https://home-assistant.io/faq/">
<meta property="og:type" content="website">
<meta property="og:description" content="Home Assistant' FAQ">
<meta property="og:description" content="Home Assistant's FAQ">
<meta property="og:image" content="https://home-assistant.io/images/default-social.png">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@home_assistant">
<meta name="twitter:title" content="FAQ">
<meta name="twitter:description" content="Home Assistant' FAQ">
<meta name="twitter:description" content="Home Assistant's FAQ">
<meta name="twitter:image" content="https://home-assistant.io/images/default-social.png">
<link href="/stylesheets/screen.css" media="screen, projection" rel="stylesheet">
<link href="/atom.xml" rel="alternate" title="Home Assistant" type="application/atom+xml">
@ -72,16 +72,16 @@
<p>When a component does not show up, many different things can be the case. Before you try any of these steps, make sure to look at the <code class="highlighter-rouge">home-assistant.log</code> file and see if there are any errors related to your component you are trying to set up.</p>
<p>If you have incorrect entries in your configuration files you can use the <code class="highlighter-rouge">check_config</code> script to assist in identifying them: <code class="highlighter-rouge">hass --script check_config</code>.</p>
<h2><a class="title-link" name="installation" href="#installation"></a> Installation</h2>
<h3><a class="title-link" name="distutilserrorsdistutilsoptionerror-must-supply-either-home-or-prefixexec-prefix----not-both" href="#distutilserrorsdistutilsoptionerror-must-supply-either-home-or-prefixexec-prefix----not-both"></a> distutils.errors.DistutilsOptionError: must supply either home or prefix/exec-prefix – not both</h3>
<p>This is a known issue if you’re on a Mac using Homebrew to install Python. Please follow <a href="https://github.com/Homebrew/brew/blob/master/docs/Homebrew-and-Python.md#note-on-pip-install---user">these instructions</a> to resolve it.</p>
<h3><a class="title-link" name="libyaml-is-not-found-or-a-compiler-error" href="#libyaml-is-not-found-or-a-compiler-error"></a> libyaml is not found or a compiler error</h3>
<p>On a Debian system, install the Python 3 YAML library by <code class="highlighter-rouge">sudo apt-get install python3-yaml</code>.</p>
<h3><a class="title-link" name="no-module-named-pip" href="#no-module-named-pip"></a> No module named pip</h3>
<p><a href="https://pip.pypa.io/en/stable/">Pip</a> should come bundled with the latest Python 3 but is omitted by some distributions. If you are unable to run <code class="highlighter-rouge">python3 -m pip --version</code> you can install <code class="highlighter-rouge">pip</code> by <a href="https://bootstrap.pypa.io/get-pip.py">downloading the installer</a> and running it with Python 3:</p>
<div class="language-bash highlighter-rouge">
<pre class="highlight"><code><span class="gp">$ </span>python3 get-pip.py
</code></pre>
</div>
<h3><a class="title-link" name="distutilserrorsdistutilsoptionerror-must-supply-either-home-or-prefixexec-prefix----not-both" href="#distutilserrorsdistutilsoptionerror-must-supply-either-home-or-prefixexec-prefix----not-both"></a> distutils.errors.DistutilsOptionError: must supply either home or prefix/exec-prefix – not both</h3>
<p>The problem which leads to <code class="highlighter-rouge">distutils.errors.DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both</code> is a known issue if you’re on a Mac using Homebrew to install Python. Please follow <a href="https://github.com/Homebrew/brew/blob/master/docs/Homebrew-and-Python.md#note-on-pip-install---user">these instructions</a> to resolve it.</p>
<h3><a class="title-link" name="libyaml-is-not-found-or-a-compiler-error" href="#libyaml-is-not-found-or-a-compiler-error"></a> libyaml is not found or a compiler error</h3>
<p>On a Debian system, install the Python 3 YAML library by <code class="highlighter-rouge">sudo apt-get install python3-yaml</code>.</p>
<h3><a class="title-link" name="pip3-command-not-found" href="#pip3-command-not-found"></a> pip3: command not found</h3>
<p>This utility should have been installed as part of the Python 3.4 installation. Check if Python 3.4 is installed by running <code class="highlighter-rouge">python3 --version</code>. If it is not installed, <a href="https://www.python.org/getit/">download it here</a>.</p>
<p>If you are able to successfully run <code class="highlighter-rouge">python3 --version</code> but not <code class="highlighter-rouge">pip3</code>, install Home Assistant by running the following command instead:</p>
@ -90,8 +90,52 @@
</code></pre>
</div>
<p>On a Debian system, you can also install python3 by <code class="highlighter-rouge">sudo apt-get install python3</code>d and pip3 by <code class="highlighter-rouge">sudo apt-get install python3-pip</code>.</p>
<h2><a class="title-link" name="usage" href="#usage"></a> Usage</h2>
<h3><a class="title-link" name="after-upgrading-your-browser-login-gets-stuck" href="#after-upgrading-your-browser-login-gets-stuck"></a> After upgrading, your browser login gets stuck</h3>
<p>After upgrading to a new version, you may notice your browser gets stuck at the “loading data” login screen. Close the window/tab and go into your browser settings and delete all the cookies for your URL. You can then log back in and it should work.</p>
<p>Android Chrome
chrome -&gt; settings -&gt; site settings -&gt; storage -&gt; search for your URL for home assistant-&gt; “clear &amp; reset”</p>
<h3><a class="title-link" name="dependencies" href="#dependencies"></a> Dependencies</h3>
<p>The dependencies which are used by Home Assistant are stored in the folder <code class="highlighter-rouge">deps</code> of the <a href="/docs/configuration/">configuration folder</a> directory. After an <a href="/docs/installation/updating/">upgrade</a> the dependences will be upgraded as well.</p>
<h3><a class="title-link" name="problems-with-dependencies" href="#problems-with-dependencies"></a> Problems with dependencies</h3>
<p>Almost all components have external dependencies to communicate with your devices and services. Sometimes Home Assistant is unable to install the necessary dependencies. If this is the case, it should show up in <code class="highlighter-rouge">home-assistant.log</code>.</p>
<p>The first step is trying to restart Home Assistant and see if the problem persists. If it does, look at the log to see what the error is. If you can’t figure it out, please <a href="https://github.com/home-assistant/home-assistant/issues">report it</a> so we can investigate what is going on.</p>
</article>
</div>
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">
<div class="grid">
<section class="aside-module grid__item one-whole lap-one-half">
<div class='section'>
<h1 class="title delta">Entries</h1>
<ul class='divided sidebar-menu'>
<li>
<b>Configuration</b>
<ul>
<li><a href='/faq#my-component-does-not-show-up'>My component does not show up</a></li>
</ul>
</li>
<li>
<b>Installation</b>
<ul>
<li><a href='/faq#no-module-named-pip'>No module named pip</a></li>
<li><a href='/faq#distutils-errors-distutilsoptionerror'>distutils.errors.DistutilsOptionError</a></li>
<li><a href='/faq#libyaml-is-not-found-or-a-compiler-error'>libyaml is not found or a compiler error</a></li>
<li><a href='/faq#pip3-command-not-found'>pip3: command not found</a></li>
</ul>
</li>
<li>
<b>Usage</b>
<ul>
<li><a href='/faq#after-upgrading-your-browser-login-gets-stuck'>After upgrading, your browser login gets stuck</a></li>
<li><a href='/faq#dependencies'>Dependencies</a></li>
<li><a href='/faq#problems-with-dependencies'>Problems with dependencies</a></li>
</ul>
</li>
</ul>
</div>
</section>
</div>
</aside>
</div>
</div>
<footer>